DOC update instructions in doc/README - again

Author: TomDLT

doc/README.md

@@ -8,22 +8,27 @@ sphinx
 sphinx_gallery
 ```
 
-## Build the website
+## Build commands
 
 ```bash
-make html
-firefox _build/html/index.html
+make clean          # Remove all files generated by the website build
+make html           # Build the website, running all the examples (slow)
+make html-noplot    # Build the website, without running all the examples (fast)
+make notebooks      # Update the notebooks directory, *after* building the website
+
+firefox _build/html/index.html  # Open the built website
 ```
 
-## Update notebooks
+## Typical full build (slow)
 
 ```bash
-make html-noplot
-make notebooks
+make html
+firefox _build/html/index.html
 ```
 
-## Remove all files generated by the website build
+## Update notebooks (fast)
 
 ```bash
-make clean
+make html-noplot
+make notebooks
 ```