fix groups and add docs to makefile

Author: JacobCoffee

Makefile

@@ -64,5 +64,27 @@ test: .state/db-initialized ## Run test suite
 
 ci: lint fmt test ## Run lint, fmt, then tests
 
+# =============================================================================
+# Documentation
+# =============================================================================
+
+##@ Documentation
+
+docs: docs-clean ## Build documentation
+	@echo "=> Building documentation"
+	@uv sync --group docs
+	@uv run sphinx-build -M html docs/source docs/_build/ -E -a -j auto --keep-going
+
+docs-serve: docs-clean ## Serve documentation with live reload
+	@echo "=> Serving documentation"
+	@uv sync --group docs
+	@uv run sphinx-autobuild docs/source docs/_build/ -j auto --port 0
+
+docs-clean: ## Clean built documentation
+	@echo "=> Cleaning documentation build assets"
+	@rm -rf docs/_build
+	@echo "=> Removed existing documentation build assets"
+
 .PHONY: help serve migrations migrate manage shell docker_shell clean
 .PHONY: lint fmt test ci
+.PHONY: docs docs-serve docs-clean

docs/source/commands.rst

@@ -8,26 +8,26 @@ Management Commands
 create_initial_data
 -------------------
 
-This command creates initial data for the app using factories. 
+.. program:: manage.py create_initial_data
+
+This command creates initial data for the app using factories.
 You can run it like::
 
     $ ./manage.py create_initial_data
 
-If you want to remove all existing data in the database before creating 
+If you want to remove all existing data in the database before creating
 new one, specify :option:`--flush` option::
 
     $ ./manage.py create_initial_data --flush
 
-If you want to specify any label to create any app specific data, 
+If you want to specify any label to create any app specific data,
 specify :option:`--app-label` option::
 
     $ ./manage.py create_initial_data --app-label jobs
 
 Command-line options
 ^^^^^^^^^^^^^^^^^^^^
 
-.. program:: manage.py create_initial_data
-
 .. option:: --flush
 
    Remove existing data in the database before creating new data.

pyproject.toml

@@ -59,6 +59,15 @@ dependencies = [
 ]
 
 [project.optional-dependencies]
+prod = [
+    "gunicorn==23.0.0",
+    "sentry-sdk[django]==2.40.0",
+    "Whitenoise==6.11.0",
+    "django-storages==1.14.4",
+    "boto3==1.26.165",
+]
+
+[dependency-groups]
 dev = [
     "factory-boy==3.3.1",
     "Faker==0.8.1",
@@ -72,16 +81,10 @@ dev = [
 ]
 docs = [
     "sphinx",
+    "sphinx-autobuild",
     "myst-parser",
     "furo",
 ]
-prod = [
-    "gunicorn==23.0.0",
-    "sentry-sdk[django]==2.40.0",
-    "Whitenoise==6.11.0",
-    "django-storages==1.14.4",
-    "boto3==1.26.165",
-]
 
 [tool.coverage.run]
 branch = true
@@ -175,3 +178,4 @@ known-first-party = [
 
 [tool.ruff.format]
 quote-style = "double"
+