document.specification.yaml

Document:
    definition: A model for documents.
    allowed_parameters:
        id:
            type: str
            description: The unique id of the document
        title:
            type: str
            description: The document title
        ISBN:
            type: int
            description: International Standard Book Number
    allowed_children:
        sections:
            type: Section
            description: The sections of the document
Section:
    definition: A model of a section of the :class:`Document`. Will contain one :class:`Paragraph`
        or more, i.e the :class:`Paragraph`(s) in the section, probably related to
        the :code:`title` of the `Document <#document>`_.
    allowed_parameters:
        id:
            type: str
            description: The id of the section
    allowed_children:
        paragraphs:
            type: Paragraph
            description: The paragraphs
Paragraph:
    definition: A model of a paragraph.
    allowed_parameters:
        contents:
            type: str
            description: Paragraph contents, which make up the :class:`Section`s.