Improve reservations and built-in documentation

[Aedalus]

• Improve reservation calendar behavior for authenticated users and filter the admin calendar to currently reservable equipment while retaining history.
• Add a reservations guide with Slack screenshots and expose it in both built-in and MkDocs navigation.
• Add generated documentation tables of contents, debug-mode cache bypassing, and responsive help-site styling.
• Navbar now turns green when local.
• Expand reservation and documentation test coverage.
• Pinned the CI version of ruff to match out requirements.txt. Seems out of date, but don't want to add a lot of lint fixes to an already cluttered PR.
• Bump version to v0.20.0

[claude]

Code review

No issues found. Checked for bugs and CLAUDE.md compliance.

[Copilot]

Pull request overview

Updates the reservation experience and the built-in documentation system for Equipment Status Board (ESB), including a new Reservations Guide shared between MkDocs and the in-app /docs/ help site. It also adjusts the admin reservations calendar to default to currently reservable equipment while preserving historical reservation records, and expands test coverage around these behaviors.

Changes:

• Add a new Reservations Guide and wire it into both MkDocs navigation and the built-in docs renderer (including generated per-page TOCs and debug cache-bypass behavior).
• Improve reservation UI behavior for authenticated users (shared navbar) and refine admin reservation calendar scoping to reservable equipment by default while retaining history.
• Expand tests for docs rendering/caching and reservation calendar output/visibility rules; bump project version and pin CI ruff version.

Reviewed changes

Copilot reviewed 18 out of 21 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
tests/test_views/test_reservation_views.py	Adds coverage for authenticated reservations page using the main navbar and for JSON-only privacy assertions.
tests/test_views/test_docs_views.py	Adds tests for the new reservations guide, generated page TOC behavior, and debug-mode cache bypassing.
tests/test_views/test_admin_reservation_views.py	Ensures archived/disabled equipment stays in history while default admin calendar columns exclude it.
tests/test_services/test_reservation_read_service.py	Validates admin calendar default columns include only reservable equipment.
README.md	Adds a Reservations Guide link and mentions Decatur Makers access URL.
pyproject.toml	Bumps project version to 0.20.0.
mkdocs.yml	Adds Reservations Guide to MkDocs nav and introduces reservation_url in extra.
esb/views/docs.py	Updates docs views to pass TOC HTML returned by docs_service.render_page.
esb/templates/reservations/index.html	Uses authenticated base layout for logged-in users; otherwise keeps public base.
esb/templates/docs/page.html	Adds a responsive “On this page” TOC sidebar and layout restructuring for docs pages.
esb/templates/base.html	Adds a debug-only “local” navbar styling hook (green) vs production dark navbar.
esb/static/css/app.css	Adds navbar-local styling and responsive/sticky TOC + screenshot/table styling for built-in docs.
esb/services/reservation_read_service.py	Splits admin reservation history vs calendar equipment scopes and filters default calendar to reservable equipment.
esb/services/docs_service.py	Adds attr_list, generates/stores TOC HTML from the same Markdown render pass, and bypasses docs cache in debug mode.
docs/reservations.md	Introduces the new Reservations Guide content, including Slack flow screenshots and role guidance.
docs/index.md	Adds reservations section and links to the Reservations Guide.
docs/administrators.md	Adds Decatur Makers production deployment notes and workflow steps.
.gitignore	Ignores local OpenSpec and Codex workspace directories.
.github/workflows/ci.yml	Pins ruff version in CI.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[jantman]

I'm certainly open to a counterpoint here, but I've tried to keep the project documentation generic and not DM-specific, with the (perhaps unrealistically optimisitc?) thought that ESB could be used by any makerspace. Up until now, I've kept all of the DM-specific stuff in our private repos...

[jantman]

I'd prefer if the one docs section that I commented on is fixed, but happy for you to merge as-is if you feel that's right.