enhance the stories

documentation/stories.md

@@ -14,7 +14,12 @@ This document is meant to explain what should happen when an user is doing XYZ.
 - configure sndiod
 - install programs from the configuration file
 
-# Adding a new VM (not disposable)
+# Adding a disposable template
+
+- USER edits the file to add the new disposable VM (based on a template)
+- nothing is done at this step
+
+# Adding a new VM
 
 - USER edits the file to add the new VM
 - USER runs the `openkubsd apply`
@@ -28,15 +33,11 @@ This document is meant to explain what should happen when an user is doing XYZ.
 - generate the NFS directory for that VM
 - generate the NFS /etc/exports line for that share (restricted to that VM)
 
-# Adding a new VM (disposable)
-
-- USER edits the file to add the new disposable VM (based on a template)
-- nothing is done at this step
-
 # Starting a VM
 
 - USER runs something like `openkubsd start foobar`
-- create a qcow2 derived from the template
+- if not a template
+  - create a qcow2 derived from the template
 - if disposable
   - generate the PF rules
   - generate the NFS directory
@@ -54,7 +55,8 @@ This document is meant to explain what should happen when an user is doing XYZ.
 
 - USER runs `openkubsd stop $vm`
 - stop the VM
-- deleting the qcow2 derived file of the template
+- if not a template
+  - deleting the qcow2 derived file of the template
 - if it's disposable
   - delete the PF rules
   - delete the NFS directory
@@ -64,7 +66,9 @@ This document is meant to explain what should happen when an user is doing XYZ.
 
 - USER removes VM foobar from the configuration file
 - USER runs `openkubsd apply`
-- extra VMs are removed
+- if template
+  - verify it's not used
+- extra VMs are removed (abort if one is running)
 - their disks are removed (USER may be asked)
 
 # Copying a file from VM A to VM B