Making WordPress.org

Opened 3 months ago

Last modified 3 months ago

#5585 new defect

The block editor handbook title links to developer.wordpress.org

Reported by: justinahinon Owned by:
Milestone: Priority: normal
Component: Developer Hub Keywords:


When you are on this page https://developer.wordpress.org/block-editor, or on any of its sub-pages, a click on the page title "Block Editor Handbook" sends to developer.wordpress.org instead of developer.wordpress.org/block-editor.

Change History (1)

#1 @coffee2code
3 months ago

  • Component changed from Handbooks to Developer Hub

Actually, I contend that the link in question ("Block Editor Handbook" in the blue site title bar) should be re-titled as "Developer Resources".

That location on any other WordPress.org property is reserved for the site's name linked to the root of the site. The link for DevHub handbooks already goes to the root of the site, but the text is changed to reflect the name of the current handbook. This is inconsistent with the rest of wordpress.org (the text should be the site's name) and is locally confusing (if it's the handbook name, one would expect the link to take you to the front page of the handbook).

What I propose instead is that the handbooks on DevHub adopt a handbook linking approach as used on a multi-handbook site such as Make/Community. As an example, see this handbook page in the Make/Community's Community Deputy Handbook. At the top of each handbook page, you'll see the handbook name with a link to the handbook's homepage.

(Note that there are already 2 existing links to the handbook front page: the first link in the sidebar and the handbook's name in the breadcrumb navigation.)

This change would need to apply to all sections of DevHub and not just handbooks. (Currently the non-handbook sections do change the link to go to the root of their section instead of linking to the DevHub homepage.)

Note: See TracTickets for help on using tickets.