Skip to content
This repository has been archived by the owner on Dec 5, 2023. It is now read-only.

Commit

Permalink
Adding news fragment for documentation changes
Browse files Browse the repository at this point in the history
- Also fixing RST formatting issues

Signed-off-by: Stephen Bunn <stephen@bunn.io>
  • Loading branch information
stephen-bunn committed Oct 7, 2019
1 parent 2466329 commit 381fcf1
Show file tree
Hide file tree
Showing 2 changed files with 5 additions and 4 deletions.
8 changes: 4 additions & 4 deletions docs/source/getting-started.rst
Original file line number Diff line number Diff line change
Expand Up @@ -61,8 +61,8 @@ You can get the schema by passing a config class to the :func:`~.schema_builder.
Currently the generated JSONSchema is pretty boring since the ``ProjectConfig`` class is totally empty.
We can add a quick title and description to the root JSONSchema object by adding two arguments to the :func:`config <file_config._file_config.config>` decorator...

- ``title`` - *Defines the title of the object in the generated JSONSchema*
- ``description`` - *Defines the description of the object in the generated JSONSchema*
- ``title`` - Defines the title of the object in the generated JSONSchema
- ``description`` - Defines the description of the object in the generated JSONSchema

.. code-block:: python
Expand All @@ -88,8 +88,8 @@ After building the schema again you can see the added ``title`` and ``descriptio

We can also control the ``$id`` and ``$schema`` properties within the generated JSONSchema but adding two more arguments to the :func:`config <file_config._file_config.config>` decorator...

- ``schema_id`` - *Defines a custom id for the generated JSONSchema's ``$id`` property*
- ``schema_draft`` - *Defines a custom draft URL for the generated JSONSchema's ``$schema`` property*
- ``schema_id`` - Defines a custom id for the generated JSONSchema's ``$id`` property
- ``schema_draft`` - Defines a custom draft URL for the generated JSONSchema's ``$schema`` property

.. code-block:: python
Expand Down
1 change: 1 addition & 0 deletions news/schema-metadata-documentation.doc
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
Adding some documentation around ``schema_id`` and ``schema_draft`` parameters for the ``@config()`` decorator in Getting Started

0 comments on commit 381fcf1

Please sign in to comment.