This actually covers two things: Metadata class usage + Metadata schema. I think that these two things should be there, in a separated section, so on the navigation panel one would see:
- Overview
- Install
- Quickstart
USER GUIDES <- or another name
- MetaData Schema <- this explains the schema in a verbose way, introducing the design principles and showing examples of each part
- MetaData Class <- A detailed step by step guide showing all the different functionalities of the MetaData class
- Connectors <- (This can be added in a later release)
RESOURCES
- JSON Schema <- The current table-based summary + maybe the complete JSON?
- API Reference
- Contributing
- Credits
- History <- maybe rename to changelogs?
Notes from @csala :