You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Documentation has some UI issues that make it harder to read - I've got fixes ready #258
I've been using the AboutCode docs a lot and noticed some UI issues that make reading harder than it needs to be. Fixed them locally and the difference is pretty noticeable. Thought I'd share!
The Issues
Main problems:
Headers are way too big (H1 takes up half the screen)
Huge gap between breadcrumbs and content
Sidebar creates massive white space when opened
Dark mode links are nearly invisible
Other stuff:
Cramped sidebar navigation (hard to click on mobile)
Lists indented too much
Inconsistent bullet styles
Content touches screen edges on mobile
Theme switcher barely visible
What I Fixed
Rewrote docs/source/_static/theme_overrides.css to fix everything:
Reduced header sizes (H1: 3rem → 2.2rem)
Fixed sidebar layout and spacing
Made dark mode links bright blue (#5ca8ff)
Better navigation spacing (0.6em padding)
Consistent list indentation (1.5rem)
Proper mobile padding
Stats: +368 lines, -8 lines (26 → 386 total)
Testing
Tested on:
✅ Desktop & mobile viewports
✅ Dark/light modes
✅ All main pages
✅ Built with sphinx-autobuild
Ready to PR
Changes are:
CSS only (no Python/Sphinx config)
Backward compatible
Well-commented
Already working locally
Questions:
Should I submit the PR?
One big PR or split by category?
Need more browser testing?
Happy to provide screenshots or make adjustments. Let me know! 😊
Activity
docs: fix critical UI issues in documentation
docs: fix critical UI issues in documentation