Remove "experimental" from full site editing docs (#37655)

* Remove "experimental" from full site editing docs With the upcoming release of WordPress 5.9, update the documents to no longer refer to the features as experimental but as released in WP 5.9 version. * Apply suggestions from code review Co-authored-by: Carolina Nymark <[email protected]> * Update version to 2, add title key to templateparts * Update docs/explanations/glossary.md * Update docs/how-to-guides/themes/create-block-theme.md * Update docs/how-to-guides/themes/create-block-theme.md * Update docs/how-to-guides/themes/create-block-theme.md * Update docs/how-to-guides/themes/create-block-theme.md Co-authored-by: Carolina Nymark <[email protected]> * Reword requires per review Co-authored-by: Carolina Nymark <[email protected]>
WordPress · Jan 9, 2022 · e9f242a · e9f242a
1 parent 1e4e1e3
commit e9f242a
Show file tree

Hide file tree

Showing 4 changed files with 85 additions and 94 deletions.
diff --git a/docs/explanations/architecture/full-site-editing-templates.md b/docs/explanations/architecture/full-site-editing-templates.md
@@ -3,7 +3,7 @@
 ## Template and template part flows
 
 <div class="callout callout-alert">
-This is the documentation for the current implementation of the block templates and template parts themes. This is part of the Full Site Editing project. These features are still experimental in the plugin. “Experimental” means this is just an early implementation that is subject to potential drastic and breaking changes in iterations based on feedback from users, contributors, and theme authors.
+This documentation is for block templates and template parts, these features are part of the Full Site Editing project releasing in WordPress 5.9.
 </div>
 
 This document will explain the internals of how templates and templates parts are rendered in the frontend and edited in the backend. For an introduction about block themes and Full site editing templates, refer to the [block theme documentation](/docs/how-to-guides/themes/block-theme-overview.md).

diff --git a/docs/explanations/glossary.md b/docs/explanations/glossary.md
@@ -38,7 +38,7 @@
 <dd>A type of block where the content of which may change and cannot be determined at the time of saving a post, instead calculated any time the post is shown on the front of a site. These blocks may save fallback content or no content at all in their JavaScript implementation, instead deferring to a PHP block implementation for runtime rendering.</dd>
 
 <dt>Full Site Editing </dt>
-<dd>This refers to a collection of features that ultimately allows users to edit their entire website using blocks as the starting point. This feature set includes everything from block patterns to global styles to templates to design tools for blocks (and more). Currently, it's still in an experimental phase.</dd>
+<dd>This refers to a collection of features that ultimately allows users to edit their entire website using blocks as the starting point. This feature set includes everything from block patterns to global styles to templates to design tools for blocks (and more). First released in WordPress 5.9.</dd>
 
 <dt>Inspector</dt>
 <dd>Deprecated term. See <a href="#settings-sidebar">Settings Sidebar.</a></dd>

diff --git a/docs/how-to-guides/themes/block-theme-overview.md b/docs/how-to-guides/themes/block-theme-overview.md
@@ -1,9 +1,7 @@
 # Block Theme
 
 <div class="callout callout-alert">
-These features are still experimental in the plugin. “Experimental” means this is just an early implementation that is subject to potential drastic and breaking changes in iterations based on feedback from users, contributors and theme authors.
-
-Documentation is shared early to surface what’s being worked on and invite feedback from those experimenting with the APIs. You can provide feedback in the weekly #core-editor chats, or #fse-outreach-experiment channels, or async via Github issues.
+These features are part of the full site editing project releasing in WordPress 5.9. You can provide feedback in the weekly #core-editor chats, or #fse-outreach-experiment channels, or async using GitHub issues.
 </div>
 
 ## What is a block theme?
@@ -131,11 +129,11 @@ A pattern block can be used to insert translatable content inside a block templa
 
 #### Example
 
-Register a pattern: 
+Register a pattern:
 
 ```php
 <?php
-register_block_pattern( 
+register_block_pattern(
  'myblocktheme/wordpress-credit',
  array(
  'title' => __( 'Wordpress credit', 'myblocktheme' ),
@@ -158,7 +156,7 @@ Load the pattern in a template or template part:
 ```html
 <!-- wp:group -->
 <div class="wp-block-group">
-<!-- wp:pattern {"slug":"myblocktheme/wordpress-credit"} /-->
+ <!-- wp:pattern {"slug":"myblocktheme/wordpress-credit"} /-->
 </div>
 <!-- /wp:group -->
 ```