Skip to content

Conversation

CamSoper
Copy link
Contributor

Summary

This PR introduces significant improvements to the documentation navigation and layout system, addressing long-standing UX issues and improving accessibility.

Key Changes

Navigation Improvements

  • Unified documentation browsing: Navigating by product on the top tab strip formerly meant you couldn't browse the entire set of documentation at once in the left nav. The new way fixes that.
  • Eliminated tab strip: Removed the product-specific tab navigation that fragmented the documentation experience
  • Search relocated: Moved search to top of left nav for better discoverability and workflow

Layout & Interaction Changes

  • Simplified width controls: Got rid of manual width selector (relying on auto sizing instead)
  • Improved left nav behavior: No more playing "Is this collapsible item also a link?" None of them are links any more. They're all only collapsible. The matching _index.md is surfaced as the top item under that collapsible section heading. This is more discoverable by providing a consistent expectation in the UI, and it also better enables accessibility via screen readers.
  • Enhanced hover states: Collapsible sections show bold text on hover (when collapsed) without background highlighting, while document links retain blue highlighting

Technical Improvements

  • CSS modernization: Everything I changed now uses rem instead of px because px is lame.
  • Responsive design: Better spacing and positioning across viewport sizes
  • Accessibility: Clearer interaction patterns for screen readers and keyboard navigation

Files Changed

  • Layout templates: New main-home.html template for main docs page
  • Navigation: Updated menu behavior and styling
  • Content: Added norightnav: true to top-level section pages
  • Styling: Converted px units to rem, improved hover states, better spacing

Test Plan

  • ✅ Verify unified left navigation works across all doc sections
  • ✅ Test responsive behavior at various viewport sizes
  • ✅ Confirm hover states work correctly (bold for sections, highlight for docs)
  • ✅ Validate search functionality in new position

🤖 Generated with Claude Code

Co-Authored-By: Claude [email protected]

@pulumi-bot

This comment was marked as outdated.

This comment was marked as resolved.

@pulumi-bot

This comment was marked as outdated.

@pulumi-bot

This comment was marked as outdated.

@meagancojocar meagancojocar marked this pull request as draft September 26, 2025 18:46
@pulumi-bot
Copy link
Collaborator

- Add enhanced robots meta tag for better crawl control
- Add preconnect hints to improve performance for external resources
- Add aria-current attribute to active breadcrumb item
- Add ARIA attributes to table of contents accordion (aria-expanded, aria-controls, aria-hidden)

These minimal, non-breaking improvements complement the navigation redesign.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants