-
Notifications
You must be signed in to change notification settings - Fork 4.2k
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
Docs: Add parent and experimental status to the core block reference #48269
Conversation
Size Change: 0 B Total Size: 1.4 MB ℹ️ View Unchanged
|
Flaky tests detected in 0a59cc7. 🔍 Workflow run URL: https://github.com/WordPress/gutenberg/actions/runs/5037016288
|
This is great @carolinan. I am noticing that it says As a side note, I am not sure how we would achieve this technically, but it would be amazing to somehow indicate when each block was last changed. 🤔 |
Yes, these are different values used in block.json: Let's add that explanation at the top where it says that items with strike through are disabled. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This looks great! Thank you @carolinan 👍
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM!
E2E test failure should not be caused by this PR, so let's re-run it and merge if everything is OK 👍
What?
Updates the core block reference page to include information about experimental status and parent block, and the last updated date.
Partial for #38573
Why?
This information was missing from the reference page.
The experimental status is especially important, since it can show the reader if the block is available in core, site editor only, or only in the plugin.
The parent is important because if you look at the block reference and then try to add, for example the "list item" block, this block will not show up in the block inserter. But with the parent information, you can still find the block.
How?
Updates the document generator script to print out the
parent
and__experimental
values from block.json.Testing Instructions
Please review the included MD file.
The button block should have an additional line:
**Parent:** core/buttons
The table of content block should have an additional line:
**Experimental:** true
Screenshots or screencast