update main examples documentation

Author: d-v-b

examples/README.md

@@ -21,18 +21,24 @@ To add a new example:
 1. Create a new subdirectory: `examples/my_example/`
 2. Add your Python code: `examples/my_example/my_example.py`
 3. Create documentation: `examples/my_example/README.md`
-4. Run the documentation generator: `python3 scripts/generate_examples_docs.py`
+4. Create a documentation page at `docs/user-guide/examples/my_example.md`. The documentation page should simply link to the `README.md` and the source code, e.g.:
 
-The documentation generator will automatically:
-- Create a documentation page at `docs/user-guide/examples/my_example.md`
-- Update `mkdocs.yml` to include the new example in the navigation
+    ````
+    # docs/user-guide/examples/my_example.md
+    --8<-- "examples/my_example/README.md"
+
+    ## Source Code
+
+    ```python
+    --8<-- "examples/my_example/my_example.py"
+    ```
+    ````
+5. Update `mkdocs.yml` to include the new example in the navigation.
 
 ### Example README.md Format
 
 Your README.md should include:
 
-- A title (# Example Name)
+- A title (`# Example Name`)
 - Description of what the example demonstrates
 - Instructions for running the example
-
-**Note:** The source code will be automatically appended to the documentation when you run the generator script.