docs: migrate from MkDocs to Sphinx with Furo theme

- Replace MkDocs with Sphinx using myst-parser for Markdown support
- Use Furo theme for improved navigation and appearance
- Add development workflow documentation page
- Merge advanced configuration into settings page
- Move DaisyUI documentation from usage to settings
- Remove redundant sections (debugging guide, testing strategies, etc.)
- Fix badge display in README with inline HTML and flex styles
- Exclude docs/ from uv-secure pre-commit hook
- Update justfile and .readthedocs.yml for Sphinx

Author: oliverandrich

.pre-commit-config.yaml

@@ -43,6 +43,7 @@ repos:
     rev: 0.15.4
     hooks:
       - id: uv-secure
+        exclude: ^docs/
 
   - repo: https://github.com/RobertCraigie/pyright-python
     rev: v1.1.407

.readthedocs.yml

@@ -7,10 +7,10 @@ build:
   tools:
     python: "3.12"
 
-mkdocs:
-  configuration: mkdocs.yml
+sphinx:
+  configuration: docs/conf.py
 
 # Optionally declare the Python requirements required to build your docs
 python:
   install:
-  - requirements: docs/requirements.txt
+    - requirements: docs/requirements.txt

CHANGELOG.md

@@ -6,6 +6,8 @@
 - **Django support**: Dropped support for Django 5.1 (now supporting Django 4.2 LTS, 5.2, and 6.0 only)
 - **Pre-commit hooks**: Updated uv-secure (0.15.4) and pyright (1.1.407)
 - **Security**: Updated Django and Werkzeug to fix security vulnerabilities
+- **Documentation**: Migrated from MkDocs to Sphinx with myst-parser and Furo theme
+- **Documentation**: Added Advanced Configuration and Development Workflow pages
 
 ### 🛠️ Developer Experience
 - **Cleanup command**: Added `just clean` target to remove temporary files and build artifacts