docs: prioritize Data Engineering in nav, fix faint section headers

Merged
AN
7mo ago
+28-16

Summary

Two changes to improve the docs sidebar from a data engineer's perspective:

1. Reorder nav to prioritize Data Engineering

Before: Getting Started → Usage → Configure → Data Engineering → ...
After: Getting Started → Data Engineering → Usage → Configure → ...

As a data engineering tool, agent modes, SQL/dbt/FinOps tools, and guides should be the first thing users see — not buried below 20+ configuration items. The new order matches the user journey:

  1. Install (Getting Started)
  2. Use the data tools (Data Engineering)
  3. Learn the interfaces (Usage)
  4. Customize (Configure)
  5. Extend (Develop)
  6. Troubleshoot (Reference)

2. Fix faint section headers

Section headers (DATA ENGINEERING, USAGE, CONFIGURE, etc.) were nearly invisible with the primary: white theme. Added custom CSS (assets/css/extra.css) to make them:

  • Bold (font-weight: 700)
  • Uppercase with letter spacing
  • Full contrast (uses default foreground color instead of faded gray)

Test plan

  • mkdocs build — zero errors
  • All 44 pages return HTTP 200
  • Custom CSS loads correctly
  • Nav order: Data Engineering appears before Usage/Configure
  • Visual review of section header styling

🤖 Generated with Claude Code