Better web interface for schema documentation

We have a web interface for schema documentation at https://metadata.datadrivendiscovery.org/, but it doesn't scale well as our schemas grow. It would be great to create something better dedicated for our program. It could be just a client-side static JavaScript code without a server component. But it could be a dynamic site.

Some ideas:

  • having a search to search across all field names and descriptions
  • having multiple tabs/pages for each schema
  • better display some of JSON schema workaround we are using (like enums with oneOf to get descriptions in)
  • or maybe even have enumerations on separate pages
  • maybe easy way to suggest/encourage people to add more values to enumerations, or some guidelines how to do so
  • and to other schema parts
  • sort things by alphabet
  • in general better handling of oneOf and similar cases
  • potential for deep-linking to something, for example if you would click on displayed field among many, background could switch to yellow and URI hash could change to something to identify what you clicked, then it is easy to share with somebody else