Design learning tools

Provide diagrams for a Virtualized Execution Environment

Propose interfaces for a cli toolkit

examples/opnsense/README.md

@@ -1,15 +1,23 @@
-## OPNSense demo
+# OPNSense Demo
 
-Download the virtualbox snapshot from {{TODO URL}}
+This example demonstrate how to manage an Opnsense server with harmony.
 
-Start the virtualbox image
+todo: add more info
 
-This virtualbox image is configured to use a bridge on the host's physical interface, make sure the bridge is up and the virtual machine can reach internet.
+## Demo instructions
 
-Credentials are opnsense default (root/opnsense)
+todo: add detailed instructions
 
-Run the project with the correct ip address on the command line :
+  - setup the example execution environment
+  - setup your system configuration
+    - topology
+    - scores
+    - secrets
+  - build
+  - execute
+  - verify/inspect
+
+## Example execution
+
+See [learning tool documentation](./scripts/README.md)
 
-```bash
-cargo run -p example-opnsense -- 192.168.5.229
-```