[WIP] Fix references to existing docs folder and update paths

[Copilot]

Thanks for asking me to work on this. I will get started on it and keep this PR's description up to date as I form a plan and make progress.

Original prompt

The user is clarifying that the 'docs' folder exists in their repository, contrary to a prior assumption that it was missing. Review the repository on branch 'main' to confirm presence, contents, and correctness of the 'docs' folder. Identify any discrepancies between the intended or referenced documentation folder and its actual use/location (naming, structure, etc). If there are residual references (in README, code, or CI/CD config) to a missing or misnamed 'docs' folder, fix all relevant links and documentation paths to ensure they match the actual folder on disk. If auxiliary files (e.g., mkdocs.yml, Sphinx conf.py) exist, update their paths accordingly. Document any corrections in a PR summary. Do NOT create, delete, or move major files without user approval if discrepancies are found, but fix all outdated references and links in files.

This pull request was created from Copilot chat.

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.