docs: add section eyebrow text above page H1#45
Merged
Conversation
Show the current topic label (e.g. TERMINAL, AGENTS, ENTERPRISE) as a small uppercase eyebrow above the H1 on every page. Helps orient readers who land directly from search without sidebar context. Derived from starlightSidebarTopics middleware (same data as the header topic nav). Styled with accent blue, xs font, 600 weight, and 0.08em letter-spacing matching the sidebar tier-1 treatment. Co-Authored-By: Oz <oz-agent@warp.dev>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Walk the sidebar tree to find the immediate parent group of the current page and show it as a breadcrumb: 'AGENTS > THIRD-PARTY CLI AGENTS' instead of just 'AGENTS'. Falls back to topic-only when the page is at the top level of its topic. Truncated to 2 levels max to keep the eyebrow short. Co-Authored-By: Oz <oz-agent@warp.dev>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Add a section eyebrow label above the H1 on every docs page to orient readers who land directly from search.
Problem
When readers arrive on a docs page from Google or an AI engine, there's no visible section context in the main content area. The sidebar shows where you are, but it's not prominent. GitBook had breadcrumb-style section context above the title; the Starlight migration lost this.
Fix
Added a small uppercase eyebrow label (e.g. "TERMINAL", "AGENTS", "ENTERPRISE") above the H1 in
CustomPageTitle.astro. The label is derived from the current sidebar topic via the samestarlightSidebarTopicsmiddleware that powersWarpTopicNav.astro.Visual treatment
var(--sl-text-xs)(13px), weight 600, uppercase, 0.08em letter-spacingvar(--sl-color-text-accent)(accent blue, theme-aware)Layout
Context
Part of the docs v2 bug bash follow-up work. Tracks to Notion item: Migration FF: page headers.
Co-Authored-By: Oz oz-agent@warp.dev