Document how to run jobs

doc/architecture.md

@@ -143,6 +143,25 @@ $ nomad operator scheduler get-config --json
 
 ### Launching services
 
+To launch a service, e.g. `app/core`, use `nomad plan` first:
+
+```
+cd cluster/staging/app/core/deploy
+nomad plan core-system.hcl
+```
+
+If the diff looks fine, then you can run the job for real
+(the index is printed in the output of `nomad plan`):
+
+```
+nomad job run -check-index NNN core-system.hcl
+```
+
+There may be several jobs in the same directory, for instance
+`core-system.hcl` and `core-service.hcl`.
+
+### Which services to launch
+
 Stuff should be started in this order:
 
 1. `app/core`

doc/onboarding.md

@@ -12,7 +12,7 @@ Basically:
   - Finally, the new administrator must choose a password to operate over SSH with `./passwd prod rick` where `rick` is the target username
 
 
-## How to operate a node (conncet to Nomad and Consul)
+## How to operate a node (connect to Nomad and Consul)
 
 Edit your `~/.ssh/config` file with content such as the following: