Blocks descriptions use inconsistent verb person and pattern #69475
Labels
Good First Issue
An issue that's suitable for someone looking to contribute for the first time
[Package] Block library
/packages/block-library
[Status] In Progress
Tracking issues with work in progress
[Type] Bug
An existing feature does not function as intended
[Type] Copy
Issues or PRs that need copy editing assistance
Description
All the blocks come with their own name and description.
One of the main places where the description is shown in the UI is in the 'block card' at the top of the Block settings panel.
Many of these description use an inconsistent verb person, the most evident is
Display
vs.Displays
(third person).There's many other verbs in use with the same inconsistency. Other descriptions use a completely different pattern. A few screenshots:
While minor, this introduces inconsistency and unnecessary cognitive load with understanding the difference between the different wordings.
At the very least I'd suggest to:
Display
vs.Displays
case.-To be discussed: whether other patterns like
The author name.
orA calendar of your site’s posts.
should be changed to use a sentence that starts with a verb.Some of the other starting verbs I found:
Other patterns examples:
Step-by-step reproduction instructions
"description"
(including the quotes) limiting the search to the/packages/block-library
directory.Screenshots, screen recording, code snippet
No response
Environment info
No response
Please confirm that you have searched existing issues in the repo.
Please confirm that you have tested with all plugins deactivated except Gutenberg.
Please confirm which theme type you used for testing.
The text was updated successfully, but these errors were encountered: