List Block Docs Page Review

[katmoody]

Issue Description

I'd recommend adding an additional heading at the top of the page (after the first paragraph) called 'How to add the List block' and revising this section for additional context/clarity.

URL of the Page with the Issue

https://wordpress.org/documentation/article/list-block/

Section of Page with the issue

After the first paragraph.

Why is this a problem?

Each of the 'Blocks' pages under Documentation / Customization / (block) should include clear information on what the block is and how to add it to the page, along with other customization details.

It's also important to have a clear hierarchy in headlines for those who scan pages to find the specific information they need. "How to add this block" would be a good additional headline.
Each of the 'Blocks' pages under Documentation / Customization / (block) should include clear information on what the block is and how to add it to the page, along with other customization details.

Page Review Items to Check

This is part of the Block pages review, and we're checking for the following items:

• Page should include info on 'How to add the block'
• Page should include info on all toolbar controls
• Page should include info on all block settings
• Page should include a Changelog
• Block names in bolded, not italicized
• Headings should use Headings (H2, H3), not be bolded
• Each relevant section should have a Heading
• Use monospaced style for slash commands

Suggested Fix

Revise current text (below):

In order to add a List Block, click on the add block button and select the List Block.

You can also type /list and hit enter in a new paragraph block to add one quickly.

Consider adding this text instead:

Open the Block Inserter tool by clicking the Block Inserter + icon in the top toolbar or in the block editor. Look for the List block by using the search bar, then click the icon to insert it into the editor.

You can also click the Block Inserter (+) icon in the editor and then choose the List block in the pop-up window.

You can also use a (/) slash command by typing /list in the editor.

[github-actions]

Heads up @WordPress/docs-issues-coordinators, we have a new issue open. Time to use 'em labels.

[katmoody]

/assign

[github-actions]

Hey @katmoody, thanks for your interest in this issue! 🍪🍪🍪
If you have any questions, do not hesitate to ask them in our #docs Slack channel.
Enjoy and happy contributing ❤️

[katmoody]

It's also worth a quick clarification as to what should be bolded. We want to bold the name of the block, but is "block" part of the name of the block?

Should it be List Block or List block?

@estelaris or @zzap ?

*I'm asking because this page uses the first option while other pages have used the second option. It should be the same for each page.