Skip to content

Switch docs theme from alabaster to furo#264

Merged
derek73 merged 2 commits into
masterfrom
docs/furo-theme
Jul 6, 2026
Merged

Switch docs theme from alabaster to furo#264
derek73 merged 2 commits into
masterfrom
docs/furo-theme

Conversation

@derek73

@derek73 derek73 commented Jul 6, 2026

Copy link
Copy Markdown
Owner

Summary

  • Replace the alabaster Sphinx theme (2014-era default, looked dated) with furo — actively maintained, built-in light/dark mode, and view-source/edit-page links wired to this repo.
  • Drop travis_button (assumed dead, no longer using Travis CI) and analytics_id (a Universal Analytics property ID; UA was fully sunset by Google in July 2023, so it was already a no-op).

Test plan

  • Built docs locally with sphinx-build -b html docs docs/_build/html — build succeeds with no new warnings
  • Rendered the built site in a browser and confirmed sidebar nav, search, and both light/dark modes work
  • Confirm the RTD build picks up furo from docs/requirements.txt on the next PR preview/deploy

🤖 Generated with Claude Code

derek73 and others added 2 commits July 6, 2026 01:41
The alabaster theme is the 2014-era Sphinx default and looked dated.
Furo is actively maintained, has a built-in light/dark mode toggle,
and wires up view-source/edit-page links to GitHub.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
alabaster rode along as a transitive dependency of sphinx itself, so
it never needed to be listed explicitly. furo has no such free ride,
so CI's `uv run sphinx-build` couldn't find the theme after the switch.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@codecov-commenter

Copy link
Copy Markdown

⚠️ Please install the 'codecov app svg image' to ensure uploads and comments are reliably processed by Codecov.

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 97.68%. Comparing base (b7b728b) to head (128971a).
❗ Your organization needs to install the Codecov GitHub app to enable full functionality.

Additional details and impacted files
@@           Coverage Diff           @@
##           master     #264   +/-   ##
=======================================
  Coverage   97.68%   97.68%           
=======================================
  Files          13       13           
  Lines         906      906           
=======================================
  Hits          885      885           
  Misses         21       21           

☔ View full report in Codecov by Harness.
📢 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.

@derek73 derek73 self-assigned this Jul 6, 2026
@derek73 derek73 added the docs Documentation fixes and updates label Jul 6, 2026
@derek73 derek73 merged commit c9e9f1b into master Jul 6, 2026
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs Documentation fixes and updates

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants