OrganizationΒΆ
As stated earlier, I needed this to manage and document rather large schemas. I wanted to organize these schemas in such a way that the number of levels remained under control.
To achieve this I wanted the schemas to be able to reference other (reusable) schemas
using the $ref
keyword. These subschemas, should be documented somewhere else but
should be all in a single file for performance reasons.
So in order to separate storage and representation I require each $ref
-erenced subschema
to be included explicitly in your .rst file.