[Documentation] Create new page listing Gutenberg releases in each WordPress version #23773
Conversation
This new page should have Project Overview as the parent. This addresses concerns brought up in #23344.
annezazu
added
[Type] Enhancement
|
Size Change: +2.21 kB (0%) Total Size: 1.14 MB
ℹ️ View Unchanged
|
| @@ -0,0 +1,38 @@ | |||
| With each WordPress release cycle, various versions of Gutenberg are included. This has created confusion over time as people try to figure out how best to debug problems and report bugs appropriately. To make this easier for everyone to keep track of, this document serves as a canonical list of the Gutenberg versions present in each WordPress release. | |||
|
|
|||
There was a problem hiding this comment.
It may also be good to note that each WordPress release also includes bug fixes from later Gutenberg releases that occur during the beta period. It's a little tricky to describe in non-technical terms, maybe something like:
"During the beta period, additional bug fixes from later Gutenberg releases than those noted are cherry-picked into the WordPress release"
It makes me wonder if we should include a very brief overview of how the beta process works, as the above sentence maybe doesn't make much sense in isolation 🤔
There was a problem hiding this comment.
Added that phrasing in. As for an overview of the beta process, I'm conflicting as that should probably belong on other pages 🤔
|
I knew I was messing something obvious up :) I'll take care of this all tomorrow. Thanks, as always, for reviewing @talldan. |
|
Just removing the Enhancement label as I think the idea at the moment is for PRs to only include one |
|
For reference, documentation for contributing documentation is here, ideally any questions would be answered there. If not, let me know and I can help answer and update. This is looking good! 👍 Personally, I would just have the last Gutenberg version, so for WP 5.5 it would just say GB 8.5, since each version builds on the previous, thus by default it contains all previous versions. However, I don't feel that strongly about it and if it seems more clear to others I'm fine with how it is. We'll need to add it to |
|
I think this is now ready for a final review!
Let's launch with how it is for now. Personally, I think showing the different Gutenberg versions in a release even in a condensed way more clearly shows just how much is being added in with each WordPress release.
After wrestling with this and with awesome help from you (thank you), I think I was able to do this! As for documentation, I mainly ran into an issue needing to update npm and node first which feels like more of an edge case than needs to be in the docs. |
Fixes #23344
This new page should have Project Overview as the parent. This addresses concerns brought up in #23344 and should make life easier for those trying to figure out what version of Gutenberg are present in each WordPress release. Of note, I included 5.5 here in light of this recent post: https://wordpress.org/news/2020/07/wordpress-5-5-beta-1/
I wasn't sure how to set a parent page so apologies if I did this wrong! Would love to learn how to do this for future reference.