Skip to content

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

Merged
anandgupta42 merged 1 commit intomainfrom
docs/improve-nav-and-styling
Mar 3, 2026
Merged

docs: prioritize Data Engineering in nav, fix faint section headers#29
anandgupta42 merged 1 commit intomainfrom
docs/improve-nav-and-styling

Conversation

@anandgupta42
Copy link
Contributor

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

As a data engineering tool, the Data Engineering section (agent modes,
tools, guides) should be the first thing users see after Getting Started —
not buried below Configure.

New nav order: Getting Started → Data Engineering → Usage → Configure →
Develop → Reference. This matches the user journey: install, use the data
tools, learn the interfaces, then customize.

Also adds custom CSS to make nav section headers (DATA ENGINEERING, USAGE,
CONFIGURE, etc.) bold uppercase with full contrast instead of the default
faint light-gray styling from the white primary theme.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@anandgupta42 anandgupta42 merged commit 6b87f0f into main Mar 3, 2026
4 checks passed
@kulvirgit kulvirgit deleted the docs/improve-nav-and-styling branch March 10, 2026 21:06
anandgupta42 added a commit that referenced this pull request Mar 17, 2026
…29)

As a data engineering tool, the Data Engineering section (agent modes,
tools, guides) should be the first thing users see after Getting Started —
not buried below Configure.

New nav order: Getting Started → Data Engineering → Usage → Configure →
Develop → Reference. This matches the user journey: install, use the data
tools, learn the interfaces, then customize.

Also adds custom CSS to make nav section headers (DATA ENGINEERING, USAGE,
CONFIGURE, etc.) bold uppercase with full contrast instead of the default
faint light-gray styling from the white primary theme.

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
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.

1 participant