wip: Use pdoc to generate API documentation

Not working correctly:
- Why isn't the markdown working properly? - Links are broken
- Issues with intra-doc links not working as I want them too

Author: Techcable

.gitignore

@@ -23,6 +23,9 @@ __pycache__
 # tox
 /.tox
 
+# generated by pdoc
+/docs
+
 ##
 ## Miscellaneous
 ##

Justfile

@@ -21,10 +21,17 @@ fix: && _format fix-spelling
     @# Failure to fix should not prevent formatting
     -ruff check --fix src
 
-build: mypy && _test check-format
+build: mypy && doc _test check-format
     # Build project
     uv build
 
+# build project documentation with `pdoc`
+#
+# See website: https://pdoc.dev/
+doc:
+    @mkdir -p docs
+    PYTHONPATH=src ./pdoc/.venv/bin/pdoc --docformat=markdown -o docs techcable.orderedset
+
 mypy:
     uv run mypy src