_Section_s shouldn't be used here...

Author: pgleeson

examples/document.py

@@ -12,7 +12,7 @@ class Paragraph(Base):
     A model of a paragraph.
 
     Args:
-        contents: Paragraph contents, which make up the _Section_s.
+        contents: Paragraph contents, which make up the :class:`Section`s.
     """
 
     contents: str = field(validator=instance_of(str))

examples/document.rst

@@ -49,8 +49,8 @@ A model of a paragraph.
 
 **Allowed parameters**
 
-===============  ===========  ===================================================
+===============  ===========  ===============================================================
 Allowed field    Data Type    Description
-===============  ===========  ===================================================
-**contents**     str          *Paragraph contents, which make up the _Section_s.*
-===============  ===========  ===================================================
+===============  ===========  ===============================================================
+**contents**     str          *Paragraph contents, which make up the `Section <#section>`_s.*
+===============  ===========  ===============================================================

examples/document.specification.json

@@ -42,7 +42,7 @@
         "allowed_parameters": {
             "contents": {
                 "type": "str",
-                "description": "Paragraph contents, which make up the _Section_s."
+                "description": "Paragraph contents, which make up the :class:`Section`s."
             }
         }
     }

examples/document.specification.yaml

@@ -30,4 +30,4 @@ Paragraph:
     allowed_parameters:
         contents:
             type: str
-            description: Paragraph contents, which make up the _Section_s.
+            description: Paragraph contents, which make up the :class:`Section`s.