feat(build): add docs generation to Makefile

- Add new 'docs' target in Makefile using sphinx-build
- Update dependencies in pyproject.toml:
  - Add asyncstdlib
  - Downgrade sphinx to ^7.3.7
  - Replace sphinx-autodoc-typehints with sphinx-book-theme

Makefile

@@ -24,6 +24,10 @@ format:
 format-check:
 	$(run) ruff --check nrk_psapi
 
+.PHONY: docs
+docs:
+	$(run) sphinx-build docs docs/_build
+
 .PHONY: setup
 setup:
 	poetry install

pyproject.toml

@@ -31,6 +31,7 @@ isodate = "^0.6.1"
 rich = "^13.8.1"
 rfeed = "^1.1.1"
 backoff = "^2.2.1"
+asyncstdlib = "^3.12.5"
 
 [tool.poetry.group.dev.dependencies]
 aresponses = "^3.0.0"
@@ -41,8 +42,8 @@ pytest = "^8.3.3"
 pytest-asyncio = "*"
 pytest-cov = "^5.0.0"
 ruff = "0.6.4"
-sphinx = "^8.0.2"
-sphinx-autodoc-typehints = "^2.4.0"
+sphinx = "^7.3.7"
+sphinx-book-theme = "^1.1.3"
 
 [tool.coverage.report]
 show_missing = true