fix building guidance

.github/workflows/deploy-documentation.yml

@@ -38,7 +38,7 @@ jobs:
 
     - name: Generate Documentation
       run: |
-        sphinx-build -b html docs/ docs/_build
+        make docs
 
     - name: Upload artifact
       uses: actions/upload-pages-artifact@v1

.gitignore

@@ -28,3 +28,5 @@ pyrightconfig.json
 
 # don't store html build file for docs
 /docs/_build
+docs/digital_land*
+docs/modules.rst

Makefile

@@ -40,17 +40,15 @@ endif
 # install pre-commits
 	pre-commit install
 
-# build docs from doc strings
-.PHONY: api-docs
-api-docs:
-	sphinx-apidoc -o docs/ api/digital_land
-# Build documentation with Sphinx
+# Build documentation with Sphinx use for deploying documentation
 .PHONY: docs
 docs: api-docs
+	sphinx-apidoc -o docs/ digital_land
 	sphinx-build -b html docs/ docs/_build
 
-# Serve the documentation locally with live-reloading
-serve-docs: api-docs
+# Serve the documentation locally with live-reloading. Use this for local building
+serve-docs:
+	sphinx-apidoc -o docs/ digital_land
 	sphinx-autobuild docs/ docs/_build --host 0.0.0.0 --port 8000
 
 # Clean up the generated documentation