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.

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

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

Closed

Conversation

juanmaguitar
Copy link
Contributor

@juanmaguitar juanmaguitar commented Apr 14, 2023

What?

Naming adjustments for Block Editor parts to be more precise and clear at the Block Editor Handbook landing page

Why?

Because these namings reflect better the current terms used for these parts


  • Block Inserter: A panel for inserting blocks into the content canvas
  • Content Canvas: The content editor, which holds content created with blocks
  • Block Inspector (settings sidebar): A panel for configuring the selected block’s settings (as a tab of the settings sidebar)

@@ -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
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

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.

@@ -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
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.

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.

docs/README.md Outdated Show resolved Hide resolved
@juanmaguitar
Copy link
Contributor Author

I close this PR as there seems to be a tendency to remove the term "block" to refer to parts of the Block Editor.
I have moved this conversation to here

@juanmaguitar juanmaguitar deleted the docs/naming-adjustments-block-editor-parts branch April 14, 2023 15:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
[Type] Developer Documentation Documentation for developers
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants