Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Wiki is not migrated #16

Closed
ReactiveRaven opened this issue Apr 17, 2016 · 11 comments
Closed

Wiki is not migrated #16

ReactiveRaven opened this issue Apr 17, 2016 · 11 comments
Labels

Comments

@ReactiveRaven
Copy link

The contents of the wiki at json-schema/json-schema/wiki have not been migrated/redirected to their new home here.

@awwright
Copy link
Member

awwright commented May 3, 2016

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

@Relequestual
Copy link
Member

@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. =/

@awwright
Copy link
Member

@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)

@Relequestual
Copy link
Member

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... =/

@handrews
Copy link
Contributor

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.

@awwright
Copy link
Member

@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.

@Relequestual
Copy link
Member

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

@handrews
Copy link
Contributor

@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 :-)

@handrews
Copy link
Contributor

@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.

@awwright
Copy link
Member

@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?

@awwright
Copy link
Member

awwright commented Dec 3, 2016

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.

@awwright awwright closed this as completed Dec 3, 2016
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

No branches or pull requests

4 participants