Update chapter list

[adamwoodnz]

Closes #265, #310, #313

Updates styling of chapter list:

• Font weights, colors, list item styles

Note: Does not include #306

Note also that the root handbook page is always shown in the current prod chapter list, so 'Best Practices' being shown on the WPCS page in the screenshots below is consistent with the other handbooks.

Screenshots

Coding standards

Block Editor

Advanced admin

[jasmussen]

Nice, this is a big win. I think it can in principle land as is.

That said, per a recent revisit to this section, some opportunities for simplification were surfaced. In the case of the chapters list, it was mainly some small things:

• Smaller chevron (chevron-small) from the WordPress Design Library.
• Chevron pointing right means collapsed, pointing down means open
• 3x3 dot instead of 4x4 dot
• Small margin tweaks.

You can dive into the Figma here.

---

I noted some larger changes as well, which I'll show here for reference. I wouldn't call any of them urgent or blocking, but they simplify the overall appearance a bit, and could be applied across any section that uses chapters or tables of content, including Documentation.

Notably the removal of dots and the background from the TOC. Both scroll with you down the page. "Back to top" can appear as you scroll a bit. Most of those changes are in the "enhancements" category and should not block anything, or even need be part of a V1. I can create issues separately if need be, but wanted your take on it first.

---

Also a think for the future, and IMO also in the nice-to-have category is the expand/collapse behavior of the left sidebar. Here's the SVG for the new icon for that, which has also been added to the WordPress Design Library:

<svg width="24" height="24" fill="none" xmlns="http://www.w3.org/2000/svg"><path fill-rule="evenodd" clip-rule="evenodd" d="M18 17.5v-11h-1.5v11H18Z" fill="#1E1E1E"/><path d="m6 12 4.25-4.5M6 12h9m-9 0 4.25 4.5" stroke="#1E1E1E" stroke-width="1.5"/></svg>

[adamwoodnz]

Thanks for the feedback @jasmussen !

In the case of the chapters list, it was mainly some small things

👍 I'll make these changes in this PR I think

I can create issues separately if need be

Yes please, a new issue in wporg-mu-plugins for the ToC changes. I might do the background and bullet changes quickly, then follow up with the rest.

Also a think for the future, and IMO also in the nice-to-have category is the expand/collapse behavior of the left sidebar

👍 I've got a separate issue for this #306

I'll also tighten up the column spacing, but that doesn't need an issue.

[adamwoodnz]

Chapter list and responsive layout updated:

Screenshots

Monitor

Desktop	Tablet	Mobile