doc: add switch to doc building script to ensure that the docs build from scratch

Author: ntamas

scripts/mkdoc.sh

@@ -4,15 +4,22 @@
 #
 # Usage: ./mkdoc.sh (makes API and tutorial docs)
 #        ./mkdoc.sh -d (makes a Dash docset based on standalone docs, requires doc2dash)
-
+#
+# Add -c to ensure that the documentation is built from scratch and no cached
+# assets from previous builds are used.
+#
 # Make sure we bail out on build errors
 set -e
 
 DOC2DASH=0
 LINKCHECK=0
+CLEAN=0
 
-while getopts ":sjdl" OPTION; do
+while getopts ":scjdl" OPTION; do
   case $OPTION in
+    c)
+      CLEAN=1
+      ;;
     d)
       DOC2DASH=1
       ;;
@@ -66,10 +73,13 @@ rm -f dist/*.whl && .venv/bin/pip wheel -q -w dist . && .venv/bin/pip install -q
 echo "Patching modularized Graph methods"
 .venv/bin/python3 ${SCRIPTS_FOLDER}/patch_modularized_graph_methods.py
 
-
 echo "Clean previous docs"
 rm -rf "${DOC_HTML_FOLDER}"
 
+if [ "x$CLEAN" = "x1" ]; then
+  # This is generated by sphinx-gallery
+  rm -rf "${DOC_SOURCE_FOLDER}/tutorials"
+fi
 
 if [ "x$LINKCHECK" = "x1" ]; then
   echo "Check for broken links"