📝 update generated v1 md (#212)

Author: sebastianMindee

docs/extras/guide/custom_v1.md

@@ -60,7 +60,7 @@ A `ListField` is a special type of custom list that implements the following:
 Since the inner contents can vary, the value isn't accessed through a property, but rather through the following functions:
 * **contents_list()** (`-> List[Union[str, float]]`): returns a list of values for each element.
 * **contents_string(separator=" ")** (`-> str`): returns a list of concatenated values, with an optional **separator** `str` between them.
-* **__str__()**: returns a string representation of all values, with an empty space between each of them.
+> **Note:** the `str()` method returns a string representation of all values of this object, with an empty space between each of them.
 
 
 #### List Field Value
@@ -79,7 +79,7 @@ A `ClassificationField` is a special type of custom classification that implemen
 
 * **value** (`str`): the value of the classification. Corresponds to one of the values specified during training.
 * **confidence** (`float`): the confidence score of the field prediction.
-* **__str__()**: returns a string representation of all values, with an empty space between each of them.
+> **Note:** the `str()` method returns a string representation of all values of this object, with an empty space between each of them.
 
 # Attributes
 

docs/extras/guide/generated_v1.md

@@ -1,7 +1,6 @@
 ---
 title: Generated API Python
 ---
-
 The Python OCR SDK supports generated APIs.
 Generated APIs can theoretically support all APIs in a catch-all generic format.
 
@@ -61,23 +60,31 @@ Since the inner contents can vary, the value isn't accessed through a property,
 
 - **contents_list()** (`-> List[Union[str, float]]`): returns a list of values for each element.
 - **contents_string(separator=" ")** (`-> str`): returns a list of concatenated values, with an optional **separator** `str` between them.
-- ****str**()**: returns a string representation of all values, appropriate spacing.
+> **Note:** the `str()` method returns a string representation of all values of this object, with an empty space between each of them.
 
-#### Generated Object Field
+### Generated Object Field
 
 Unrecognized structures and sometimes values of `ListField`s are stored in a `GeneratedObjectField` structure, which is implemented dynamically depending on the object's structure.
 
-No matter what, the fields will be stored in a dictionary-like structure with a `key: value` pair where `key` is a string and `value` is a nullable string. The object also contains:
-
 - **page_id** (`Optional[int]`): the ID of the page, is `None` when at document-level.
+- **raw_value** (`Optional[str]`): an optional field for when some post-processing has been done on fields (e.g. amounts). `None` in most instances.
+- **confidence** (`Optional[float]`): the confidence score of the field prediction. Warning: support isn't guaranteed on all APIs.
+
+
+> **Other fields**:No matter what, other fields will be stored in a dictionary-like structure with a `key: value` pair where `key` is a string and `value` is a nullable string. They can be accessed like any other regular value, but won't be suggested by your IDE.
+
+
+### StringField
+The text field `StringField` only has one constraint: its **value** is an `Optional[str]`.
+
 
 # Attributes
 
 Generated builds always have access to at least two attributes:
 
 ## Fields
 
-**fields** (`Dict[str`: `List[Union[`[GeneratedListField](#generated-list-field)[GeneratedObjectField](#generated-object-field), `StringField]]`):
+**fields** (`Dict[str`: `List[Union[`[GeneratedListField](#generated-list-field)[GeneratedObjectField](#generated-object-field), `(#stringfield)[StringField]]]`):
 
 ```python
 print(str(result.document.inference.prediction.fields["my-field"]))