Skip to content
This repository was archived by the owner on Nov 2, 2023. It is now read-only.
This repository was archived by the owner on Nov 2, 2023. It is now read-only.

Proposal for new json-schema website #1

Closed
@Relequestual

Description

@Relequestual

@json-schema-org/owners

Plan proposals

Apologies for not having gotten to writing this proposal out sooner. I think we can all agree, time on this project is stretched thin!

First before discussing the new website, I think some pre-work is needed regarding the structure of the json-schema working group, and formalising yourselves as chairs of the project (if you are willing). I am happy to take on some responsibility for public communications and organisational elements for the project.

My suggested plan is as follows

  1. Review the list of libraries which implement json-schema and the json-schema test suite, and ask each of them if they would like to become involved in json-schema, including an explanation of the current state of affiars (of course after your approval on the wording). I would also like to ask them what teams they could see within the project, and any high level elements they would like to be involved in.
  2. Further, scan through the curren open issues, looking for any potentially interested individuals who also might like to be involved in the project, asking similar questions.
  3. Once this is completed, there should be a list of individuals who are keen to contribute to the re-establishing of the projects workforce. We could then create a private google group to enable internal communications. I would also encouridge everyone to join the irc channel on freenode.
  4. With an established working group, who can then evaluate and re-establish the requirements for draft 5. If I understand / have read correctly, the plan was for draft 5 to be a tidy up release, before the first version of the specification is put out as an RFC. (Speaking of which, did the project get any responses from the RFC? If so, how do we get hold of them?)

This will allow the project to evaluate the state of draft 5, and how to move forward to make it ready for publishing as an RFC. (I'd like to be part of the review process for this!)

I noticed that getting draft 5 sorted has been raised as issues here json-schema/json-schema#167 and here json-schema/json-schema#130 . cc'ed so people can follow discussions.

Regarding the website

Part of contacting a number of people, I would seek comments on the current website, looking to evaluate if it meets the current users expectation and needs. I'd do this in the form of a google questionaire.

If a re-structure of the site is needed, consider a few alternatives.

Start re-build using bootstrap. Bootstrap would allow for a faster build, while also making it easier for others to contribute. After some basic layouts are constructed, create a number of github issues and associated milestones for the website rebuild.

I'd like to also spend some time on / directing people involved, to the Understanding JSON Schema web book from the Space Telescope Institute. Maybe something on how to get involved in the specification.

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions