Docs published to Github Pages using gh action

[matagus]

Description

1. Replaced the all-in-one action with individual steps for more control
2. Added Python setup using actions/setup-python@v5 with Python 3.14
3. Install dependencies from pyproject.toml using pip install .[docs] which installs the project with the docs optional dependencies (mkdocs, mkdocs-material, pygments, pymdown-extensions)
4. Build MkDocs explicitly with mkdocs build
5. Deploy using a more modern action (peaceiris/actions-gh-pages@v4) that deploys the built ./site directory to GitHub Pages

Checklist:

• I'm following the Contributing Guidelines.
• I have added the relevant tests for this change.
• I have updated the README.md file accordingly (if necessary).

[codecov-commenter]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 78.72%. Comparing base (87169b1) to head (b08a417).

Additional details and impacted files

@@           Coverage Diff           @@
##             main      #17   +/-   ##
=======================================
  Coverage   78.72%   78.72%           
=======================================
  Files          12       12           
  Lines          94       94           
=======================================
  Hits           74       74           
  Misses         20       20           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.