diff --git a/substrate/README.adoc b/substrate/README.adoc
index 30a8076f90..f0aa15c4f9 100644
--- a/substrate/README.adoc
+++ b/substrate/README.adoc
@@ -147,6 +147,22 @@ Now, edit `~/chainspec.json` in your editor. There are a lot of individual field
       },
 ----
 
+[source, shell]
+----
+substrate build-spec --chain ~/chainspec.json --raw > ~/mychain.json
+----
+
+[source, shell]
+----
+substrate --chain ~/mychain.json
+----
+
+[source, shell]
+----
+substrate --chain ~/mychain.json --validator --key ...
+----
+
+
 == Building
 
 === Hacking on Substrate