Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Block Editor Handbook :: Landing Page :: Naming adjustments for block editor parts #49824

Closed
wants to merge 3 commits into from
Closed

Block Editor Handbook :: Landing Page :: Naming adjustments for block editor parts #49824

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
8adbb30
naming adjustments for block editor parts
juanmaguitar Apr 14, 2023
f6156e8
uppercase adjustments to improve readability
juanmaguitar Apr 14, 2023
df20e30
Updates the sidebar inspector naming and description
priethor Apr 14, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions docs/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,9 +10,9 @@ The editor consists of several primary elements, as shown in the following figur

The elements highlighted in the figure are:

1. **Inserter**: A panel for inserting blocks into the content canvas
2. **Content canvas**: The content editor, which holds content created with blocks
3. **Settings sidebar.**: A sidebar panel for configuring a block’s settings (among other things)
1. **Block Inserter**: A panel for inserting blocks into the content canvas
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should this be called just the "Inserter"? Using it you can insert patterns and media, as well as blocks.

Copy link
Contributor Author

@juanmaguitar juanmaguitar Apr 14, 2023 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That's a good question.
At https://wordpress.org/documentation/article/wordpress-block-editor/ this part is called "Block Inserter".
I think the reasoning is that patterns and/or media are at the end just different ways of inserting blocks.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In my review of the previous landing page PR, I asked @mburridge to change it to Inserter for those same reasons. I would avoid using Blocks here similarly to how we are starting to say Templates more instead of Block Templates.

2. **Content Canvas**: The content editor, which holds content created with blocks
3. **Sidebar Inspector **: A sidebar containing different setting options, like the Block, Post, and Styles Inspectors, depending on the editor's context.

Through the Block editor, you create content modularly using Blocks. There are a number of [core blocks](https://developer.wordpress.org/block-editor/reference-guides/core-blocks/) ready to be used, and you can also [create your own custom block](https://developer.wordpress.org/block-editor/getting-started/create-block/).

Expand Down Expand Up @@ -71,4 +71,4 @@ This handbook should be considered the canonical resource for all things related
- [/apis](https://developer.wordpress.org/apis) - Common APIs Handbook
- [/advanced-administration](https://developer.wordpress.org/advanced-administration) - WP Advanced Administration Handbook
- [/rest-api](https://developer.wordpress.org/rest-api/) - REST API Handbook
- [/coding-standards](https://developer.wordpress.org/coding-standards) - Best practices for WordPress developers
- [/coding-standards](https://developer.wordpress.org/coding-standards) - Best practices for WordPress developers