Updates based on reviews.

docs/Makefile

@@ -64,6 +64,10 @@ help:
 clean:
 	rm -rf $(BUILDDIR)
 	rm -rf $(STAGINGDIR)
+
+	# TODO(Lunderberg): Remove these lines once the CI steps have
+	# propagated.
+
 	# Remove folders that have since been relocated into
 	# $(STAGINGDIR).  This allows `task_sphinx_precheck.sh` to
 	# run, even if a commit that predates $(STAGINGDIR) was
@@ -74,6 +78,12 @@ clean:
 	rm -rf vta/tutorials
 
 staging:
+	# Prepare the staging directory.  Sphinx gallery automatically
+	# writes new .rst files into the current directory.  This can
+	# cause issues when switching branches.  By sequestering the
+	# auto-generated files into the staging directory, they can be
+	# removed without knowing the exact directory.
+
 	mkdir -p $(STAGINGDIR)
 
 	# Remove any symlinks that currently exist

docs/conf.py

@@ -52,8 +52,8 @@
     tvm_path = Path(os.pardir)
 
 
-sys.path.insert(0, str(tvm_path.joinpath("python")))
-sys.path.insert(0, str(tvm_path.joinpath("vta", "python")))
+sys.path.insert(0, str(tvm_path / "python"))
+sys.path.insert(0, str(tvm_path / "vta" / "python"))
 
 # -- General configuration ------------------------------------------------
 
@@ -213,20 +213,21 @@ def git_describe_version(original_version):
 gallery_dirs = ["tutorials", "vta/tutorials"]
 
 subsection_order = ExplicitOrder(
-    [
-        str(tvm_path.joinpath("tutorials", "get_started")),
-        str(tvm_path.joinpath("tutorials", "frontend")),
-        str(tvm_path.joinpath("tutorials", "language")),
-        str(tvm_path.joinpath("tutorials", "optimize")),
-        str(tvm_path.joinpath("tutorials", "autotvm")),
-        str(tvm_path.joinpath("tutorials", "auto_scheduler")),
-        str(tvm_path.joinpath("tutorials", "dev")),
-        str(tvm_path.joinpath("tutorials", "topi")),
-        str(tvm_path.joinpath("tutorials", "deployment")),
-        str(tvm_path.joinpath("tutorials", "micro")),
-        str(tvm_path.joinpath("vta", "tutorials", "frontend")),
-        str(tvm_path.joinpath("vta", "tutorials", "optimize")),
-        str(tvm_path.joinpath("vta", "tutorials", "autotvm")),
+    str(p)
+    for p in [
+        tvm_path / "tutorials" / "get_started",
+        tvm_path / "tutorials" / "frontend",
+        tvm_path / "tutorials" / "language",
+        tvm_path / "tutorials" / "optimize",
+        tvm_path / "tutorials" / "autotvm",
+        tvm_path / "tutorials" / "auto_scheduler",
+        tvm_path / "tutorials" / "dev",
+        tvm_path / "tutorials" / "topi",
+        tvm_path / "tutorials" / "deployment",
+        tvm_path / "tutorials" / "micro",
+        tvm_path / "vta" / "tutorials" / "frontend",
+        tvm_path / "vta" / "tutorials" / "optimize",
+        tvm_path / "vta" / "tutorials" / "autotvm",
     ]
 )