Update documentation with global variables examples

Co-authored-by: kevinbackhouse <[email protected]>

Author: Copilot

README.md

@@ -77,6 +77,18 @@ Example: deploying a Taskflow:
 hatch run main -t examples.taskflows.example
 ```
 
+Example: deploying a Taskflow with command line global variables:
+
+```sh
+hatch run main -t examples.taskflows.example_globals -g fruit=apples
+```
+
+Multiple global variables can be set:
+
+```sh
+hatch run main -t examples.taskflows.example_globals -g fruit=apples -g color=red
+```
+
 ## Deploying from Docker
 
 You can deploy the Taskflow Agent via its Docker image using `docker/run.sh`.
@@ -104,6 +116,13 @@ Example: deploying a Taskflow (example.yaml):
 ```sh
 docker/run.sh -t example
 ```
+
+Example: deploying a Taskflow with global variables:
+
+```sh
+docker/run.sh -t example_globals -g fruit=apples
+```
+
 Example: deploying a custom taskflow (custom_taskflow.yaml):
 
 ```sh

doc/GRAMMAR.md

@@ -340,6 +340,20 @@ taskflow:
         Tell me more about {{ GLOBALS_fruit }}.
 ```
 
+Global variables can also be set or overridden from the command line using the `-g` or `--global` flag:
+
+```sh
+hatch run main -t examples.taskflows.example_globals -g fruit=apples
+```
+
+Multiple global variables can be set by repeating the flag:
+
+```sh
+hatch run main -t examples.taskflows.example_globals -g fruit=apples -g color=red
+```
+
+Command line globals override any globals defined in the taskflow YAML file, allowing you to reuse taskflows with different parameter values without editing the files.
+
 ### Reusable Tasks
 
 Tasks can reuse single step taskflows and optionally override any of its configurations. This is done by setting a `uses` field with a link to the single step taskflow YAML file as its value.