Coder Social home page Coder Social logo

Comments (11)

awwright avatar awwright commented on May 22, 2024

This might be able to be done with a Git push, I think GitHub keeps the wiki as a (hidden) Git repo somewhere.

from json-schema-spec.

Relequestual avatar Relequestual commented on May 22, 2024

@awwright you're right on that! If you think it will help, I'll look into migrating the wiki, and then how we can redirect people from the old one. Maybe insert something at the top of each file. Assuming I can write to it that is. =/

from json-schema-spec.

awwright avatar awwright commented on May 22, 2024

@Relequestual I think I can do that, but I'd like to spend at least a trivial amount of time thinking if we can improve the wiki. I think 90% of the content on it now is either better suited for either the website (getting started and documentation) or the issue tracker (feature proposals)

from json-schema-spec.

Relequestual avatar Relequestual commented on May 22, 2024

Agreed on that!

If you update a wiki page and then delete it, does the creator get notfiied? For items that are migrated to issues, we will need some mechanism for letting people know where their wiki pages have gone.

I still struggle to understand why people were directed to the wiki for making suggestions... =/

from json-schema-spec.

handrews avatar handrews commented on May 22, 2024

I'm assuming this stalled as the last comment is several months old.

I have started auditing the spec-related wiki pages alongside the audit of the old repo issues that I already started and posted to the Google group. I currently do not plan to do anything with wiki pages that are not directly related to advancing the specification work.

My plan, unless someone suggests otherwise, is to go over the wiki pages, the old repo's issues, and the new repo's issues, and distill all of the spec work down into issues on the new repo that can be filed with a summary of all of the past discussions. At this point, many feature discussions are spread over a wiki page and multiple issues filed against both the old and new repos. Many initially-different proposals converge on the same set of major proposals.

For letting people know what happens with the wiki, we can just edit the pages and either completely replace their contents with a link to the new issue, or just prominent feature such a link at the top of the page. There's no problem with editing the old wiki- I just fixed a broken link there right now.

@awwright please let me know if you would like for me to continue with this, either as stated or with a modified approach.

from json-schema-spec.

awwright avatar awwright commented on May 22, 2024

@handrews That sounds mostly good, for entries on the old wiki perhaps let's link to the relevant issue here; if any.

We should only create issues for proposals that mesh suitably well with the existing goal of annotating or validating JSON documents. Other goals... we'll have to figure them out based on their merits, I guess.

from json-schema-spec.

Relequestual avatar Relequestual commented on May 22, 2024

To my mind, the core goal of JSON Schema is to enable a systematic and complete means to validate a JSON document.

from json-schema-spec.

handrews avatar handrews commented on May 22, 2024

@awwright : I definitely intend to crosslink every which way that seems remotely useful and not too confusing.

@Relequestual : I'd also really like to figure out the right way to think about hyper-schema alongside the validation requirements. But not in this issue :-)

from json-schema-spec.

handrews avatar handrews commented on May 22, 2024

@awwright are you able to close issues in the old repo? Or do we need to try to get the attention of the original filers to close them?

I was going to suggest an alternative of creating some new labels to advertise issue status, but it looks like even if you can create new labels there I can't use them.

from json-schema-spec.

awwright avatar awwright commented on May 22, 2024

@ReactiveRaven I think we've sort of settled on trying to move as much as possible into either the issue tracker or the website. Does that solution work for you?

from json-schema-spec.

awwright avatar awwright commented on May 22, 2024

I'll close this out for inactivity... If there's any particular things missing from the website or wiki feel free to open an issue in the appropriate tracker.

from json-schema-spec.

Related Issues (20)

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.