Add support for uv run make livehtml

Author: hermanzdosilovic

Makefile

@@ -18,3 +18,8 @@ help:
 # "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
 %: Makefile
 	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+# Add -b dirhtml for main_nav_links to work as expected.
+# Add --pre-build "rm -rf build" to ensure a clean build directory.
+livehtml:
+	sphinx-autobuild -b dirhtml --pre-build "rm -rf build" "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

pyproject.toml

@@ -6,5 +6,6 @@ readme = "README.md"
 requires-python = ">=3.13"
 dependencies = [
     "sphinx>=8.2.3",
+    "sphinx-autobuild>=2025.8.25",
     "sphinxawesome-theme>=5.3.2",
 ]

source/contribute.rst

@@ -17,12 +17,21 @@ Contribute
    - `Quick reStructuredText <https://docutils.sourceforge.io/docs/user/rst/quickref.html>`_
    - `The reStructuredText_ Cheat Sheet: Syntax Reminders <https://docutils.sourceforge.io/docs/user/rst/cheatsheet.rst>`_
 
-6. Build your changes locally.
+6. Start a live preview server to see your changes in real-time.
 
    .. code-block:: bash
 
-      rm -rf build; uv run make html
+      uv run make livehtml
 
-7. Open the generated HTML files (``./build/html/index.html``) in your browser to review your changes.
-8.  Commit and push your changes to your forked repository.
+7. Open your web browser and navigate to `http://localhost:8000 <http://localhost:8000>`_ to view the documentation.
+8. Commit and push your changes to your forked repository.
 9. Create a pull request to the main repository.
+
+Adding Packages
+---------------
+
+To add a new package, use the following command:
+
+.. code-block:: bash
+
+    uv add <package-name> # e.g. uv add sphinx-autobuild