
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.
