docs(api): move around attribute comments

Author: umarbutler

openapi.yaml

@@ -1688,35 +1688,8 @@ components:
           items:
             $ref: '#/components/schemas/EnrichmentResult'
           type: array
-          description: 'The input documents enriched into version 1.0.0 of the Isaacus
-            Legal Graph Schema (IGLS).
-
-
-            All spans in an enriched document graph are indexed into the Unicode code
-            point space of a source document. Access to source documents is thus required
-            to resolve spans into text.
-
-
-            The start and end indices of spans are zero-based (i.e., the first Unicode
-            code point in the document is at index 0) and half-open (i.e., the end
-            index is exclusive).
-
-
-            All spans are globally laminar and well-nested similar to XML—it is impossible
-            for any two spans to partially overlap; they can only be disjoint, adjacent,
-            or wholly nested.
-
-
-            Spans of the exact same type (e.g., segments) will never be duplicated.
-
-
-            Spans cannot be empty and will never start or end at whitespace.
-
-
-            When using programming languages other than Python (which uses zero-based,
-            half-open, Unicode code point-spaced string indexing), indices may need
-            to be translated accordingly (for example, JavaScript slices into UTF-16
-            code units instead of Unicode code points).'
+          description: The enriched documents alongside, and in order of, their indices
+            in the input array of texts.
           examples:
           - version: ilgs@1
             text: '[42] The U.S. Attorney General, Mr. McGill, argued at ¶ 21 of the
@@ -3847,8 +3820,34 @@ components:
       - junk
       - version
       title: ILGSv1 Document
-      description: The document enriched into version 1.0.0 of the Isaacus Legal Graph
-        Schema (ILGS).
+      description: 'The document enriched into version 1.0.0 of the Isaacus Legal
+        Graph Schema (IGLS).
+
+
+        All spans in an enriched document graph are indexed into the Unicode code
+        point space of a source document.
+
+
+        The start and end indices of spans are zero-based (i.e., the first Unicode
+        code point in the document is at index 0) and half-open (i.e., the end index
+        is exclusive).
+
+
+        All spans are globally laminar and well-nested similar to XML—it is impossible
+        for any two spans to partially overlap; they can only be disjoint, adjacent,
+        or wholly nested.
+
+
+        Spans of the exact same type (e.g., segments) will never be duplicated.
+
+
+        Spans cannot be empty and will never start or end at whitespace.
+
+
+        When using programming languages other than Python (which uses zero-based,
+        half-open, Unicode code point-spaced string indexing), indices may need to
+        be translated accordingly (for example, JavaScript slices into UTF-16 code
+        units instead of Unicode code points).'
       examples:
       - version: ilgs@1
         text: '[42] The U.S. Attorney General, Mr. McGill, argued at ¶ 21 of the Filing