Rearrange documentation of FDSN EHs to a separate section

FDSN · Dec 5, 2022 · 68b730e · 68b730e
1 parent 10c9391
commit 68b730e
Show file tree

Hide file tree

Showing 3 changed files with 28 additions and 14 deletions.
diff --git a/extra-headers.rst b/extra-headers.rst
@@ -24,21 +24,10 @@ Extra headers are specified and documented in `JSON Schema <http://json-schema.o
 FDSN Reserved Headers
 ----------------------------
 
-The key named **"FDSN"** with value of an JSON object in the root
-container of the extra headers is reserved for definition by the FDSN.
-The documentation and schema of these headers are specified in JSON
-Schema here:
+The **"FDSN"** key at the root of the extra headres are reserved for
+definition by the FDSN.  
 
-.. raw:: html
-  :file: extra-headers/ExtraHeaders-FDSN-v1.0.schema.html
-
-|
-
-Download `FDSN Extra Header schema v1.0 <https://raw.githubusercontent.com/iris-edu/miniSEED3/main/extra-headers/ExtraHeaders-FDSN-v1.0.schema.json>`_.
-
-When not present, the boolean values in the FDSN reserved headers
-should be considered to be `false` unless otherwise documented.  Such
-values do not need to be included when the value is `false`.
+See :ref:`fdsn-reserved-headers` for documentation of these headers.
 
 See :ref:`example-fdsn-extra-headers` for an example of FDSN extra headers.
 

diff --git a/fdsn-reserved.rst b/fdsn-reserved.rst
@@ -0,0 +1,24 @@
+.. _FDSN-reserved-headers:
+
+======================
+FDSN Reserved Headers
+======================
+
+The **"FDSN"** key at the root of the :ref:`extra-headers` are reserved for
+definition by the FDSN.  See :ref:`example-fdsn-extra-headers` for an example
+of FDSN extra headers.
+
+The FDSN reserved headers are defined and documented in `JSON Schema <http://json-schema.org/>`_.
+
+Download the `FDSN Extra Header schema v1.0 <https://raw.githubusercontent.com/iris-edu/miniSEED3/main/extra-headers/ExtraHeaders-FDSN-v1.0.schema.json>`_.
+
+The documentation and schema of these headers may be browsed here:
+
+.. raw:: html
+  :file: extra-headers/ExtraHeaders-FDSN-v1.0.schema.html
+
+|
+
+When not present, the boolean values in the FDSN reserved headers
+should be considered to be `false` unless otherwise documented.  Such
+values do not need to be included when the value is `false`.
diff --git a/index.rst b/index.rst
@@ -27,6 +27,7 @@ such as location, instrument response, etc.
    definition
    data-encodings
    extra-headers
+   fdsn-reserved
    background
    appendix
    software