Schema Mapping
--------------

In addition to validating a document against the schema specified in its
``interface`` field, this library can map schema URIs to files based on their
filepaths within the backend storage. The purpose is to uphold an orderly
directory structure by specifying the oldest supported schema version
against which files will (in the near future) be validated at the point that
they are written to the system.

The current implemented convention is that:

- The root of the document path corresponds to the schema name
- The first subdirectory corresponds to the major version number
- The returned schema is the earliest compatible minor version i.e. zero

For example a document with key ``ska-telmodel-layout/v1/layout.json`` would
correspond to the schema URI
``https://schema.skao.int/ska-telmodel-layout/1.0``.

.. warning::

    This convention assumes that for a given major version of a schema, all
    minor versions are forward and backward compatible with each other. If
    this is not true the document may not validate against the path-mapped
    schema.