Opened 6 years ago

Closed 5 years ago

#3965 closed enhancement (fixed)

Add breadcrumbs to handbook pages

Reported by: coffee2code's profile coffee2code Owned by: coffee2code's profile coffee2code
Milestone: Priority: normal
Component: Handbooks Keywords: has-screenshots


When on a given handbook page, it can be difficult to determine the context of that page within the hierarchy of the handbook. If the sidebar is visible, a visitor can use that to ascertain the context, though perhaps not always quickly or clearly if the sidebar menu is sizable. At narrow viewports where the sidebar gets hidden under a hamburger icon, there is no indicator of context.

Breadcrumbs would make a handbook page's context clear, and facilitate navigating up to one of its ancestor pages.

Note: The handbooks in DevHub have already long had breadcrumbs. Adding support to the Handbook plugin will make the feature more universally available and should eventually supplant DevHub's custom version.

Attached is a screenshot showing how a handbook page would look at a narrow viewport with no sidebar but with breadcrumbs. Without the breadcrumbs, it's not immediately apparent whereabouts within the handbook the page is.

Attachments (1)

meta-3965.narrow-mockup.png (110.3 KB) - added by coffee2code 6 years ago.
Mockup of breadcrumbs on narrow viewport, as mentioned in ticket.

Download all attachments as: .zip

Change History (5)

6 years ago

Mockup of breadcrumbs on narrow viewport, as mentioned in ticket.

#1 @coffee2code
6 years ago

In 7916:

Handbook plugin: Add support for breadcrumbs.

See #3965.

#2 @coffee2code
6 years ago

In 7917:

Breathe: Show breadcrumbs for handbook pages.

See #3965.

#3 @coffee2code
5 years ago

In 8047:

Gutenberg: Show breadcrumbs for handbook pages.

See #3965.

#4 @coffee2code
5 years ago

  • Resolution set to fixed
  • Status changed from assigned to closed

Resolving this as fixed.

All the Make handbooks, and now the Gutenberg handbook, have breadcrumbs. In the ticket I mentioned converting DevHub's existing breadcrumbs to use the implementation provided by the Handbooks plugin, but the DevHub implementation is more robust and used elsewhere on the site (e.g. the Code Reference) so it can't be so simply replaced.

Note: See TracTickets for help on using tickets.