Just the Docs Files

Release v0.11.0

Happy new year folks! As promised, this is a very quick release following 0.10.2 that makes some bigger changes to the theme to improve its accessibility. In some corner cases, these are breaking changes, though I do not anticipate that this will affect most users. Separately, there are some styling changes that will look different -- but should also generally improve the accessibility of the theme for its users.

I'm also immensely grateful to @cycomachead, who submitted a PR in 2024 to run automated accessibility tests (via aXe) over our entire site. I have been chipping away at various accessibility issues surfaced by this PR over the past two years. After fixing the majority of them, we have added his suite as part of our light scheme CI pipeline. This should help theme users better meet the WCAG 2.1 AA accessibility standards (and others). Outside of reverse-footnotes, the majority of our docs site (and test sites) pass WAVE with no errors!

I plan to continue improving the accessibility of the theme - particularly in dark mode - in future PRs. I also hope to be more active in theme maintenance in 2026. Thank you everybody for your support!

Migrating to v0.11.0

Migration: users may need to migrate if:

• they have custom code that imports OneLightJekyll and OneDarkJekyll
• they have theme: legacy_light in their _config.yml
• they have a custom _includes/components/sidebar.html and/or _includes/components/footer.html`
• have custom code or logic that relies on .site-footer outside of _includes/nav_footer_custom.html

For more, refer to POTENTIALLY-BREAKING CHANGES IN v0.11.0 in the migration guide..

Theme

• Fixed: low-contrast syntax highlighting via accessible-pygments and harsher backgrounds by @mattxwang in #1749
• Fixed: callout body text color contrast by @mattxwang in #1748
• Fixed: button and label color contrast by @mattxwang in #1750
• Fixed: inability to focus on scrollable code blocks via keyboard navigation by @mattxwang in #1533
• Fixed: .site-footer focus order on sm (mobile) viewport by @mattxwang in #1751
• Fixed: color contrast between dark mode background and $link-color by @mattxwang in #1752
• Fixed: color contrast for selected .nav-list-link in light mode by @mattxwang in #1753
• Fixed: sidebar ARIA role (by including navigation) by @mattxwang in #1754
• Fixed: footer_content/footer_custom color contrast by @mattxwang in #1755

Documentation

• Added: aXe accessibility tests by @cycomachead in #1756

New Contributors

• @cycomachead made their first contribution in [#1756] (which is [#1513] rebased)