aboutsummaryrefslogtreecommitdiffstatshomepage
diff options
context:
space:
mode:
authorRob Herring <robh@kernel.org>2021-03-25 10:47:08 -0600
committerRob Herring <robh@kernel.org>2021-03-27 12:58:04 -0600
commit9be21f7358125d7c862bb34915dc0ad2446ffd78 (patch)
tree96623c208218b71740e3d0c3cab8e4d8010dd8d1
parentdocs: dt: writing-schema: Remove spurious indentation (diff)
downloadwireguard-linux-9be21f7358125d7c862bb34915dc0ad2446ffd78.tar.xz
wireguard-linux-9be21f7358125d7c862bb34915dc0ad2446ffd78.zip
docs: dt: writing-schema: Include the example schema in the doc build
The example-schema.yaml file serves as documentation, so let's include it from writing-schema.rst. Cc: Frank Rowand <frowand.list@gmail.com> Cc: Mauro Carvalho Chehab <mchehab@kernel.org> Signed-off-by: Rob Herring <robh@kernel.org> Reviewed-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org> Link: https://lore.kernel.org/r/20210325164713.1296407-4-robh@kernel.org
-rw-r--r--Documentation/devicetree/writing-schema.rst11
1 files changed, 11 insertions, 0 deletions
diff --git a/Documentation/devicetree/writing-schema.rst b/Documentation/devicetree/writing-schema.rst
index 03e279d8fd6a..be14dbed6081 100644
--- a/Documentation/devicetree/writing-schema.rst
+++ b/Documentation/devicetree/writing-schema.rst
@@ -8,6 +8,8 @@ written in a JSON compatible subset of YAML. YAML is used instead of JSON as it
is considered more human readable and has some advantages such as allowing
comments (Prefixed with '#').
+Also see :ref:`example-schema`.
+
Schema Contents
---------------
@@ -170,3 +172,12 @@ json-schema Resources
`JSON-Schema Specifications <http://json-schema.org/>`_
`Using JSON Schema Book <http://usingjsonschema.com/>`_
+
+.. _example-schema:
+
+Annotated Example Schema
+------------------------
+
+Also available as a separate file: :download:`example-schema.yaml`
+
+.. literalinclude:: example-schema.yaml