docs: explain how to run the scenarios

Sponsored-by: author

1 files changed, 13 insertions, 0 deletions

diff --git a/debian.md b/debian.md
index da26c56..32d86c6 100644
--- a/debian.md
+++ b/debian.md
@@ -11,6 +11,19 @@ to verify the acceptance criteria, based on scenarios specified here.
 
 # Acceptance criteria
 
+This chapter contains requirements and scenarios that verify they are
+met. To generate code from the scenarios and run it, use the following
+commands:
+
+~~~sh
+subplot codegen debian.subplot -o test.py
+python3 test.py --env DEBIAN_HOST=xyzzy --env HOME=$HOME --log test.log
+~~~
+
+This runs the scenarios against the host `xyzzy`, and writes a log
+file to `test.log`. The environment variable `HOME` is copied to the
+test program so that it can use your normal SSH configuration.
+
 ## Can log in via SSH as the `debian` user and become root with sudo
 
 _Requirement: The system administrator can log in and do things as