docs: fix critical UI issues in documentation

[gyanranjanpanda]

Summary

This pull request addresses the UI/UX issues reported in #258 by implementing targeted CSS improvements to the documentation theme. The changes focus on the most critical usability concerns while maintaining minimal impact on the existing codebase.

Changes Made

The following modifications have been made to docs/source/_static/theme_overrides.css:

1. Header Size Optimization

   • Reduced H1 font size to 2.2rem for improved readability
   • Reduced H2 font size to 1.8rem for better visual hierarchy

2. Dark Mode Link Visibility

   • Updated link color to #5ca8ff in dark mode for enhanced contrast and accessibility

3. Navigation Spacing Improvements

   • Added 0.6em padding to sidebar navigation links for better touch target accessibility

4. List Indentation Adjustment

   • Standardized list indentation to 1.5rem for consistent content formatting

Code Impact: 27 lines added

Testing

The changes have been thoroughly tested:

• ✅ Verified on desktop and mobile viewports
• ✅ Tested in both dark and light mode themes
• ✅ Validated across all main documentation pages
• ✅ Successfully built using sphinx-autobuild

Technical Notes

• These are CSS-only modifications with no changes to Python code or Sphinx configuration
• All changes are backward compatible
• The modifications maintain the existing design system while addressing usability concerns

I appreciate your consideration of this contribution and am happy to make any adjustments as needed.

[gyanranjanpanda]

isual Comparison: Before and After UI Fixes
🔴 Before (Current Production)

Issues identified:

Header too large (3rem) - Oversized headers reduce content visibility
Poor link contrast - Links are difficult to read in dark mode
Tight spacing - Sidebar navigation feels cramped
Excessive indent - Nested lists push content too far right
🟢 After (With Fixes Applied)

Improvements made:
Header fixed: 2.2rem - Balanced, professional typography
Better contrast: #5ca8ff - High-contrast blue for improved readability
Better spacing: 0.6em - Comfortable navigation spacing
Reduced indent: 1.5rem - Standard indentation for better flow

[DennisClark]

looks good