docs(website): more robust custom experiment docs (#284)

- Add point.yaml to density example
- Load point.yaml and python density custom_experiment example from the files in the example folder
- Update tox.ini to run the density example

Author: michael-johnston

examples/density_example/point.yaml

@@ -0,0 +1,8 @@
+# Copyright (c) IBM Corporation
+# SPDX-License-Identifier: MIT
+entity:
+  mass: 8
+  volume: 4
+experiments:
+- actuatorIdentifier: custom_experiments
+  experimentIdentifier: calculate_density

tox.ini

@@ -53,6 +53,7 @@ commands=
     pytest -n auto --dist worksteal -rx -vv --log-level=INFO --color=yes plugins/actuators/sfttrainer/ado_actuators/sfttrainer/tests/
     # Basic test of custom experiment examples
     ado describe experiment calculate_density
+    run_experiment examples/density_example/point.yaml
     # Basic test of ray_tune
     ado get operator ray_tune
     ado template operation --operator-name=ray_tune

website/docs/actuators/creating-custom-experiments.md

@@ -47,16 +47,9 @@ In the simplest case:
 `output_property_identifiers` parameter of the decorator
 
 ```python
-from typing import Dict, Any
-from orchestrator.modules.actuators.custom_experiments import custom_experiment
-
-
-@custom_experiment(
-    output_property_identifiers=["density"]
-)
-def calculate_density(mass: float, volume: float) -> Dict[str, Any]:
-    density_value = mass / volume if volume else None
-    return {"density": density_value}
+{%
+   include "../../../examples/density_example/density/density.py"
+%}
 ```
 
 **Experiment Naming:**  
@@ -113,7 +106,7 @@ To add your experiments to `ado`:
 2. Run:
 
    ```shell
-   ado describe actuators --details
+   ado get actuators --details
    ```
 
 All custom experiments are made available in `ado` through
@@ -127,13 +120,11 @@ You can test your custom experiment
 using the [`run_experiment`](run_experiment.md) command line tool.
 Save the following YAML to a file `point.yaml`
 
+<!-- markdownlint-disable-next-line first-line-h1 -->
 ```yaml
-entity:
-  mass:8
-  volume:4
-experiments:
-- actuatorIdentifier: custom_experiments
-  experimentIdentifier: calculate_density
+{%
+   include "../../../examples/density_example/point.yaml"
+%}
 ```
 
 then execute: