Update API description and SDK dataset push (#30154)

* Update API description and SDK

* Capitalize boolean

* Capitalize boolean

---------

Co-authored-by: Bryce Eadie <[email protected]>

Author: CFLJacquet

content/en/llm_observability/experiments/_index.md

@@ -190,13 +190,12 @@ expected_output_columns=["answer"]
 {{% collapse-content title="Push a dataset to Datadog" level="h4" expanded=false id="dataset-push" %}}
 
 ```python
-Dataset.push(overwrite: boolean = None, new_version: boolean = None)
+Dataset.push(new_version: boolean = None)
 ```
 
 | Parameter | Type | Description |
 | --------- | ---- | ----------- |
-| `overwrite` | boolean | If `True`, overwrites the dataset rows of an existing version. |
-| `new_version` | boolean | If `True`, creates a new version of the dataset in Datadog. Defaults to `True`.<br/><br/>This flag is useful for creating a new dataset with entirely new data. |
+| `new_version` | Boolean | If `True`, creates a new version of the dataset in Datadog, otherwise it modifies it in place. Defaults to `True`.|
 
 **Example**
 
@@ -220,7 +219,7 @@ Dataset.as_dataframe(multiindex: bool = True) -> pd.DataFrame
 
 | Parameter | Type | Description |
 | --------- | ---- | ----------- |
-| `multiindex` | boolean | If `True`, expands nested dictionaries into [MultiIndex][6] columns. Defaults to `True`. |
+| `multiindex` | Boolean | If `True`, expands nested dictionaries into [MultiIndex][6] columns. Defaults to `True`. |
 
 **Returns**
 
@@ -273,7 +272,7 @@ Experiment.run(jobs: int = 10, raise_errors: bool = False, sample_size: int = No
 | Parameter | Type | Description |
 | --------- | ---- | ----------- |
 | `jobs` | int | Number of worker threads used to run the task concurrently. Defaults to 10. |
-| `raise_errors` | boolean | If `True`, stops execution as soon as the first exception from the task is raised.<br/><br/>If `False`, every exception is handled, and the experiment runs continually until finished. |
+| `raise_errors` | Boolean | If `True`, stops execution as soon as the first exception from the task is raised.<br/><br/>If `False`, every exception is handled, and the experiment runs continually until finished. |
 | `sample_size` | int | Number of rows used for the experiment. You can use `sample_size` with `raise_errors` to test before you run a long experiment. |
 
 **Returns**
@@ -301,7 +300,7 @@ Experiment.run_evaluations(evaluators: Optional[List[Callable]] = None, raise_er
 | Parameter | Type | Description |
 | --------- | ---- | ----------- |
 | `evaluators` | function[] | List of functions decorated with `@evaluator` that run against all outputs in the results. |
-| `raise_errors` | boolean | If `True`, stops execution as soon as the first exception from the task is raised.<br/><br/>If `False`, every exception is handled, and the experiment runs continually until finished. |
+| `raise_errors` | Boolean | If `True`, stops execution as soon as the first exception from the task is raised.<br/><br/>If `False`, every exception is handled, and the experiment runs continually until finished. |
 
 **Returns**
 
@@ -321,7 +320,7 @@ ExperimentResults.as_dataframe(multiindex: bool = True) -> pd.DataFrame
 
 | Parameter | Type | Description |
 | --------- | ---- | ----------- |
-| `multiindex` | boolean | If `True`, expands nested dictionaries into [MultiIndex][6] columns. Defaults to `True`.  |
+| `multiindex` | Boolean | If `True`, expands nested dictionaries into [MultiIndex][6] columns. Defaults to `True`.  |
 
 **Returns**
 
@@ -668,8 +667,8 @@ List all dataset records, sorted by creation date. The most recently-created rec
 | ---- | ---- | ---- |
 | `id` | string | Unique record ID. |
 | `dataset_id` | string | Unique dataset ID. |
-| `input` | any valid JSON type (string, int, object, etc.) | Data that serves as the starting point for an experiment. |
-| `expected_output` | any valid JSON type (string, int, object, etc.) | Expected output |
+| `input` | any (string, number, Boolean, object, array) | Data that serves as the starting point for an experiment. |
+| `expected_output` | any (string, number, Boolean, object, array) | Expected output |
 | `metadata` | json | Arbitrary user-defined metadata. |
 | `created_at` | timestamp | Timestamp representing when the resource was created. |
 | `updated_at` | timestamp | Timestamp representing when the resource was last updated. |
@@ -690,8 +689,8 @@ Appends records for a given dataset.
 
 | Field | Type | Description |
 | ---- | ---- | ---- |
-| `input` (_required_) | any valid JSON type (string, int, object, etc.) | Data that serves as the starting point for an experiment. |
-| `expected_output` | any valid JSON type (string, int, object, etc.) | Expected output |
+| `input` (_required_) | any (string, number, Boolean, object, array) | Data that serves as the starting point for an experiment. |
+| `expected_output` | any (string, number, Boolean, object, array) | Expected output |
 | `metadata` | json | Arbitrary user-defined metadata. |
 
 **Response**
@@ -710,8 +709,8 @@ Partially update a dataset record object. Specify the fields to update in the pa
 
 | Field | Type | Description |
 | ---- | ---- | ---- |
-| `input` | any valid JSON type (string, int, object, etc.) | Data that serves as the starting point for an experiment. |
-| `expected_output` | any valid JSON type (string, int, object, etc.) | Expected output |
+| `input` | any (string, number, Boolean, object, array) | Data that serves as the starting point for an experiment. |
+| `expected_output` | any (string, number, Boolean, object, array) | Expected output |
 | `metadata` | json | Arbitrary user-defined metadata. |
 
 **Response**
@@ -720,8 +719,8 @@ Partially update a dataset record object. Specify the fields to update in the pa
 | ---- | ---- | ---- |
 | `id` | string | Unique record ID. |
 | `dataset_id` | string | Unique dataset ID. |
-| `input` | any valid JSON type (string, int, object, etc.) | Data that serves as the starting point for an experiment. |
-| `expected_output` | any valid JSON type (string, int, object, etc.) | Expected output |
+| `input` | any (string, number, Boolean, object, array) | Data that serves as the starting point for an experiment. |
+| `expected_output` | any (string, number, Boolean, object, array) | Expected output |
 | `metadata` | json | Arbitrary user-defined metadata. |
 | `created_at` | timestamp | Timestamp representing when the resource was created. |
 | `updated_at` | timestamp | Timestamp representing when the resource was last updated. |
@@ -891,9 +890,9 @@ Handle the ingestion of experiment spans or respective evaluation metrics.
 | Field | Type | Description |
 | ---- | ---- | ---- |
 | `error` | [Error](#object-error) | Captures errors. |
-| `input` (_required_) | any valid JSON type (string, int, object, etc.) | Input value to an operation. |
-| `output` (_required_) | any valid JSON type (string, int, object, etc.) | Output value to an operation. |
-| `expected_output` | any valid JSON type (string, int, object, etc.) | Expected output value. |
+| `input` (_required_) | any (string, number, Boolean, object, array) | Input value to an operation. |
+| `output` (_required_) | any (string, number, Boolean, object, array) | Output value to an operation. |
+| `expected_output` | any (string, number, Boolean, object, array) | Expected output value. |
 | `metadata` | json | Arbitrary user-defined metadata. |
 
 #### Object: EvalMetric