Skip to content

RDoc-4106 Lack of active state in docs subpage select is misleading - #2671

Open
poissoncorp wants to merge 1 commit into
ravendb:mainfrom
poissoncorp:RDoc-4106-sidebar-active-state
Open

poissoncorp wants to merge 1 commit into
ravendb:mainfrom
poissoncorp:RDoc-4106-sidebar-active-state

Conversation

@poissoncorp

Copy link
Copy Markdown
Contributor

Issue link

RDoc-4106 Lack of active state in docs subpage select is misleading

Additional description

The section you are in was removed from the switcher and replaced by a generic "Start" entry, so the list showed every destination except the current one. In Quill that left "Guides" and "Samples" reading as Quill's own.

Keep every section on the list and mark the current one active instead. The entry links to the section landing page, so it also covers what "Start" did.

Both sidebars now render one shared list from getSectionNavItems(), which drops the per-section conditionals and the hover-only "Switch" labels. Desktop and mobile had drifted apart in the meantime: different order, and mobile still used the sparkles icon for Quill.

Was:
image
image

Now:
image
image

image

Type of change

  • Content - docs
  • Content - cloud
  • Content - Quill
  • Content - guides
  • Content - start pages/other
  • New docs feature (consider updating /templates or readme)
  • Bug fix
  • Optimization
  • Other

Changes in docs URLs

  • No changes in docs URLs
  • Articles are restructured, URLs will change, mapping is required (update /scripts/redirects.json file, set Documents Moved PR label)

Changes in UX/UI

  • No changes in UX/UI
  • Changes in UX/UI (include screenshots and description)

The section you are in was removed from the switcher and replaced by a generic
"Start" entry, so the list showed every destination except the current one. In
Quill that left "Guides" and "Samples" reading as Quill's own.

Keep every section on the list and mark the current one active instead. The
entry links to the section landing page, so it also covers what "Start" did.

Both sidebars now render one shared list from getSectionNavItems(), which drops
the per-section conditionals and the hover-only "Switch" labels. Desktop and
mobile had drifted apart in the meantime: different order, and mobile still used
the sparkles icon for Quill.
@poissoncorp
poissoncorp force-pushed the RDoc-4106-sidebar-active-state branch from 2d36482 to b3f1fb6 Compare September 15, 2026 12:13
external?: boolean;
}

const NAV_SECTIONS: readonly { type: PathTypeValue; label: string; icon: IconName; currentOnly?: boolean }[] = [

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we use a concrete type here?


// Versionless content areas, in match order. The URL segment doubles as the landing page path.
// Anything that matches none of these is versioned documentation.
const SECTIONS: readonly { segment: string; type: PathTypeValue }[] = [

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Here we can also use a concrete type to be consistent

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.

2 participants