docs(api): move around attribute comments

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 5
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/isaacus%2Fisaacus-3d30398ce36763aa90f81282ad98137f5c8165e5421b7ac3475557134557de86.yml
-openapi_spec_hash: 7fda17ba5bd5e3d2b3d539e6d8660a3d
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/isaacus%2Fisaacus-1ac4ab9a8019f580de9a0cdf695fc1d6e933e28d3421eaed6fbb108ef0f66d9e.yml
+openapi_spec_hash: c5a97cf51cd410674412c8c509f3fcc5
 config_hash: 9040e7359f066240ad536041fb2c5185

src/isaacus/types/enrichment_response.py

@@ -20,26 +20,10 @@ class Result(BaseModel):
     document: Document
     """
     The document enriched into version 1.0.0 of the Isaacus Legal Graph Schema
-    (ILGS).
-    """
-
-
-class Usage(BaseModel):
-    """Statistics about the usage of resources in the process of enriching the input."""
-
-    input_tokens: int
-    """The total number of tokens inputted to the model."""
-
-
-class EnrichmentResponse(BaseModel):
-    results: List[Result]
-    """
-    The input documents enriched into version 1.0.0 of the Isaacus Legal Graph
-    Schema (IGLS).
+    (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.
+    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
@@ -59,5 +43,20 @@ class EnrichmentResponse(BaseModel):
     instead of Unicode code points).
     """
 
+
+class Usage(BaseModel):
+    """Statistics about the usage of resources in the process of enriching the input."""
+
+    input_tokens: int
+    """The total number of tokens inputted to the model."""
+
+
+class EnrichmentResponse(BaseModel):
+    results: List[Result]
+    """
+    The enriched documents alongside, and in order of, their indices in the input
+    array of texts.
+    """
+
     usage: Usage
     """Statistics about the usage of resources in the process of enriching the input."""

src/isaacus/types/ilgs/v1/document.py

@@ -23,7 +23,19 @@
 
 class Document(BaseModel):
     """
-    The document enriched into version 1.0.0 of the Isaacus Legal Graph Schema (ILGS).
+    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).
     """
 
     text: str