Making WordPress.org

Opened 5 years ago

Closed 5 years ago

Last modified 5 years ago

#4467 closed enhancement (fixed)

Redesign the sidebar for Gutenberg Handbook

Reported by: rilwis's profile rilwis Owned by: coffee2code's profile coffee2code
Milestone: Priority: normal
Component: Handbooks Keywords: needs-design-feedback
Cc:

Description

The sidebar of the Gutenberg Handbook is not user-friendly and should be updated:

https://developer.wordpress.org/block-editor/tutorials/block-tutorial/writing-your-first-block-type/

Here are some problems with it:

  • It's too narrow.
  • The navigation has up to 3 levels, but the text of sub-levels has the same size and style as the parent, which makes it hard to scan.
  • Dividers between items are not good enough, especially for sub-items.

I'd suggest:

  • Make it wider, probably 300px or more
  • Make the down arrow icon smaller or not taking too much space.
  • Sub-items should be full-width, not having a large right padding like they do now.
  • Decrease font-size for sub-items.
  • Remove the dividing lines between items.

To make it easier to navigate, I think we can separate items into categories (top-level item = category, 2nd-level = items in the category), put each category title bolder, maybe uppercase. Separate them with space, like this:

https://i.imgur.com/hiKsLm8.png

Change History (8)

This ticket was mentioned in Slack in #docs by coffee2code. View the logs.


5 years ago

This ticket was mentioned in Slack in #meta by tellyworth. View the logs.


5 years ago

#3 @tellyworth
5 years ago

  • Keywords needs-design-feedback added

#4 @coffee2code
5 years ago

In 9428:

Developer theme: More handbook sidebar menu design improvements.

  • Decrease padding-right for menu items which do not have children
  • Embolden the name of the current page in the menu

Props rilwis, coffee2code.
See #4901, #4467.

#5 @coffee2code
5 years ago

In 9429:

Developer theme: Decrease width of sidebar menu expand/collapse buttons.

Also fixes emboldening of active menu item.

Props rilwis, coffee2code.
See #4467.

#6 @coffee2code
5 years ago

  • Owner set to coffee2code
  • Resolution set to fixed
  • Status changed from new to closed

In 9430:

Breathe theme: Improve handbook sidebar menu design.

  • Eliminate per-item top/bottom borders
  • Use WCAG-compliant color (as used for links) for left border
  • Increase thickness of left border for menu sub-items
  • Reduce padding-left to align widget title with leftmost text within widget
  • Decrease padding-right for menu items which do not have subchildren
  • Embolden the name of the current page in the menu

Props rilwis, felipeloureirosantos, dufresnesteven, coffee2code.
Fixes #4901, #4467.

#7 @coffee2code
5 years ago

In 9431:

Breathe theme: Decrease width of sidebar menu expand/collapse buttons.

Props rilwis, coffee2code.
See #4467.

#8 @coffee2code
5 years ago

#4901 is a related ticket which has led to a number of improvements to handbook sidebar menus. Between changes made for that ticket, and changes referenced above, I consider this particular request fulfilled.

Of the five suggestions made in the ticket, only two have not been implemented:

  • Make it wider, probably 300px or more
  • Decrease font-size for sub-items

At this time these particular changes don't seem warranted.

Note: See TracTickets for help on using tickets.