Replace occurence of howto-guides with how-to-guides

docs/contributors/design/reference.md

@@ -15,4 +15,4 @@ Released under GPL license, made by [Cristel Rossignol](https://twitter.com/cris
 
 ## Mockups
 
-Mockup Sketch files are available in [the Design section](/docs/howto-guides/designers/design-resources.md).
+Mockup Sketch files are available in [the Design section](/docs/how-to-guides/designers/design-resources.md).

docs/contributors/documentation/document.md

@@ -39,7 +39,7 @@ To update an existing page:
 
 ### Create a New Document
 
-To add a new documentation page requires a working JavaScript development environment to build the documentation, see the [JavaScript build setup documentation](/docs/howto-guides/javascript/js-build-setup.md):
+To add a new documentation page requires a working JavaScript development environment to build the documentation, see the [JavaScript build setup documentation](/docs/how-to-guides/javascript/js-build-setup.md):
 
 1. Create a Markdown file in the [docs](https://github.com/WordPress/gutenberg/tree/HEAD/docs) folder, use lower-case, no spaces, if needed a dash separator, and .md extension.
 2. Add content, all documents require one and only H1 tag, using markdown notation.
@@ -73,7 +73,7 @@ An example, the link to this page is: `/docs/contributors/document.md`
 
 The code example in markdown should be wrapped in three tick marks \`\`\` and should additionally include a language specifier. See this [GitHub documentation around fenced code blocks](https://help.github.com/en/github/writing-on-github/creating-and-highlighting-code-blocks).
 
-A unique feature to the Gutenberg documentation is the `codetabs` toggle, this allows two versions of code to be shown at once. This is used for showing both `ESNext` and `ES5` code samples. For example, [on this block tutorial page](/docs/howto-guides/block-tutorial/block-controls-toolbar-and-sidebar.md).
+A unique feature to the Gutenberg documentation is the `codetabs` toggle, this allows two versions of code to be shown at once. This is used for showing both `ESNext` and `ES5` code samples. For example, [on this block tutorial page](/docs/how-to-guides/block-tutorial/block-controls-toolbar-and-sidebar.md).
 
 Here is an example `codetabs` section:
 

docs/explanations/architecture/full-site-editing-templates.md

@@ -2,7 +2,7 @@
 
 > This is the documentation for the current implementation of the block-based 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 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-based themes and Full site editing templates, refer to the [block-based themes documentation](/docs/howto-guides/themes/block-based-themes.md).
+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-based themes and Full site editing templates, refer to the [block-based themes documentation](/docs/how-to-guides/themes/block-based-themes.md).
 
 ## Storage
 

docs/explanations/architecture/key-concepts.md

@@ -59,4 +59,4 @@ Note: custom post types can also be initialized with a starting `post_content` t
 
 ## Global Styles (in progress)
 
-Describes a set of configuration and default properties of blocks and their visual aspects. Global Styles is both an interface (which users access through the site editor) and a configuration system done through [a `theme.json` file](/docs/howto-guides/themes/theme-json.md). This file absorbs most of the configuration aspects usually scattered through various `add_theme_support` calls to simplify communicating with the editor. It thus aims to improve declaring what settings should be enabled, what attributes are supported, what specific tools a theme offers (like a custom color palette), the available design tools present both globally and on each block, and an infrastructure that allows to enqueue only the relevant CSS based on what blocks are used on a page.
+Describes a set of configuration and default properties of blocks and their visual aspects. Global Styles is both an interface (which users access through the site editor) and a configuration system done through [a `theme.json` file](/docs/how-to-guides/themes/theme-json.md). This file absorbs most of the configuration aspects usually scattered through various `add_theme_support` calls to simplify communicating with the editor. It thus aims to improve declaring what settings should be enabled, what attributes are supported, what specific tools a theme offers (like a custom color palette), the available design tools present both globally and on each block, and an infrastructure that allows to enqueue only the relevant CSS based on what blocks are used on a page.

docs/getting-started/README.md

@@ -26,15 +26,15 @@ The Editor offers rich new value to users with visual, drag-and-drop creation to
 
 ### Develop for the block editor
 
-Whether you want to extend the functionality of the block editor, or create a plugin based on it, [see the developer documentation](/docs/howto-guides/README.md) to find all the information about the basic concepts you need to get started, the block editor APIs and its architecture.
+Whether you want to extend the functionality of the block editor, or create a plugin based on it, [see the developer documentation](/docs/how-to-guides/README.md) to find all the information about the basic concepts you need to get started, the block editor APIs and its architecture.
 
 - [Gutenberg Architecture](/docs/architecture/readme.md)
 - [Block Style Variations](/docs/reference-guides/filters/block-filters.md#block-style-variations)
 - [Creating Block Patterns](/docs/reference-guides/block-api/block-patterns.md)
-- [Theming for the Block Editor](/docs/howto-guides/themes/readme.md)
+- [Theming for the Block Editor](/docs/how-to-guides/themes/readme.md)
 - [Block API Reference](/docs/reference-guides/block-api/readme.md)
 - [Block Editor Accessibility](/docs/reference-guides/accessibility.md)
-- [Internationalization](/docs/howto-guides/internationalization.md)
+- [Internationalization](/docs/how-to-guides/internationalization.md)
 
 ### Contribute to the block editor
 

docs/getting-started/faq.md

@@ -339,7 +339,7 @@ function gutenbergtheme_editor_styles() {
 add_action( 'enqueue_block_editor_assets', 'gutenbergtheme_editor_styles' );
 ```
 
-*See:* [Editor Styles](/docs/howto-guides/themes/theme-support.md#editor-styles)
+*See:* [Editor Styles](/docs/how-to-guides/themes/theme-support.md#editor-styles)
 
 ## Should I be concerned that Gutenberg will make my plugin obsolete?
 

docs/getting-started/tutorials/README.md

@@ -2,18 +2,18 @@
 
 -   First things first, see [setting up your development environment](/docs/getting-started/tutorials/devenv/readme.md) for the tools and setup you need to extend the block editor.
 
--   See the [Getting Started with JavaScript Tutorial](/docs/howto-guides/javascript/readme.md) to learn about how to use JavaScript within WordPress.
+-   See the [Getting Started with JavaScript Tutorial](/docs/how-to-guides/javascript/readme.md) to learn about how to use JavaScript within WordPress.
 
 -   Beginners: The [Create a Block Tutorial](/docs/getting-started/tutorials/create-block/readme.md) walks through creating a block plugin using the `@wordpress/create-block` package; a quick and easy way to start creating your own block.
 
--   Intermediate: The [Block Tutorial](/docs/howto-guides/block-tutorial/readme.md) covers different aspects of block development. The documentation is slightly dated but still valid, if you are new to block development, start with the Create Block Tutorial above.
+-   Intermediate: The [Block Tutorial](/docs/how-to-guides/block-tutorial/readme.md) covers different aspects of block development. The documentation is slightly dated but still valid, if you are new to block development, start with the Create Block Tutorial above.
 
--   See the [Meta Boxes Tutorial](/docs/howto-guides/metabox/readme.md) for new ways of extending the editor storing and using post meta data.
+-   See the [Meta Boxes Tutorial](/docs/how-to-guides/metabox/readme.md) for new ways of extending the editor storing and using post meta data.
 
--   Check out the [Notices Tutorial](/docs/howto-guides/notices/README.md) to learn how to display informational UI at the top of the editor.
+-   Check out the [Notices Tutorial](/docs/how-to-guides/notices/README.md) to learn how to display informational UI at the top of the editor.
 
--   The [Sidebar Tutorial](/docs/howto-guides/sidebar-tutorial/plugin-sidebar-0.md) will walk you through the steps of creating a sidebar to update data from the `post_meta` table.
+-   The [Sidebar Tutorial](/docs/how-to-guides/sidebar-tutorial/plugin-sidebar-0.md) will walk you through the steps of creating a sidebar to update data from the `post_meta` table.
 
--   Learn how to add customized buttons to the toolbar with the [Format API tutorial](/docs/howto-guides/format-api/).
+-   Learn how to add customized buttons to the toolbar with the [Format API tutorial](/docs/how-to-guides/format-api/).
 
 -   Build your own [custom block editor instance](/docs/reference-guides/platform/custom-block-editor/) - this will walk you through building a standalone instance of the block editor within WP Admin.

docs/getting-started/tutorials/create-block/block-anatomy.md

@@ -2,7 +2,7 @@
 
 At its simplest, a block in the WordPress block editor is a JavaScript object with a specific set of properties.
 
-**Note:** Block development uses ESNext syntax, this refers to the latest JavaScript standard. If this is unfamiliar, I recommend reviewing the [ESNext syntax documentation](/docs/howto-guides/javascript/esnext-js.md) to familiarize yourself with the newer syntax used in modern JavaScript development.
+**Note:** Block development uses ESNext syntax, this refers to the latest JavaScript standard. If this is unfamiliar, I recommend reviewing the [ESNext syntax documentation](/docs/how-to-guides/javascript/esnext-js.md) to familiarize yourself with the newer syntax used in modern JavaScript development.
 
 Here is the complete code for registering a block:
 

docs/getting-started/tutorials/create-block/finishing.md

@@ -12,11 +12,11 @@ You can visually browse the components and what their implementation looks like
 
 The **RichText component** allows for creating a richer input besides plain text, allowing for bold, italic, links, and other inline formating. See the [RichText Reference](/docs/reference-guides/richtext.md) for documentation using this component.
 
-The InspectorPanel (the settings on the right for a block) and Block Controls (toolbar controls) have a standard way to be implemented. See the [Block controls tutorial](/docs/howto-guides/block-tutorial/block-controls-toolbar-and-sidebar.md) for additional information.
+The InspectorPanel (the settings on the right for a block) and Block Controls (toolbar controls) have a standard way to be implemented. See the [Block controls tutorial](/docs/how-to-guides/block-tutorial/block-controls-toolbar-and-sidebar.md) for additional information.
 
-The [Sidebar tutorial](/docs/howto-guides/sidebar-tutorial/plugin-sidebar-0.md) is a good resource on how to create a sidebar for your plugin.
+The [Sidebar tutorial](/docs/how-to-guides/sidebar-tutorial/plugin-sidebar-0.md) is a good resource on how to create a sidebar for your plugin.
 
-Nested blocks, a block that contains additional blocks, is a common pattern used by various blocks such as Columns, Cover, and Social Links. The **InnerBlocks component** enables this functionality, see the [Using InnerBlocks documentation](/docs/howto-guides/block-tutorial/nested-blocks-inner-blocks.md).
+Nested blocks, a block that contains additional blocks, is a common pattern used by various blocks such as Columns, Cover, and Social Links. The **InnerBlocks component** enables this functionality, see the [Using InnerBlocks documentation](/docs/how-to-guides/block-tutorial/nested-blocks-inner-blocks.md).
 
 ## How did they do that
 

docs/getting-started/tutorials/create-block/wp-plugin.md

@@ -112,7 +112,7 @@ For the `editorScript` provided in the block metadata, the build process creates
 
 The `wp_register_script` function used internally registers a name, called the handle, and relates that name to the script file. The dependencies are used to specify if the script requires including other libraries. The version is specified so the browser will reload if the file changed.
 
-The `wp_set_script_translations` function tells WordPress to load translations for this script, if they exist. See more about [translations & internationalization.](/docs/howto-guides/internationalization.md)
+The `wp_set_script_translations` function tells WordPress to load translations for this script, if they exist. See more about [translations & internationalization.](/docs/how-to-guides/internationalization.md)
 
 With the above in place, create a new post to load the editor and check your plugin is in the inserter. You can use `/` to search, or click the box with the [+] and search for "Gutenpride" to find the block.
 
@@ -124,7 +124,7 @@ To open the developer tools in Firefox, use the menu selecting Web Developer : T
 
 Try running `npm run start` that will start the watch process for automatic rebuilds. If you then make an update to `src/index.js` file, you will see the build run, and if you reload the WordPress editor you'll see the change.
 
-For more info, see the build section of the [Getting Started with JavaScript tutorial](/docs/howto-guides/javascript/js-build-setup.md) in the Block Editor Handbook.
+For more info, see the build section of the [Getting Started with JavaScript tutorial](/docs/how-to-guides/javascript/js-build-setup.md) in the Block Editor Handbook.
 
 ## Summary
 

docs/howto-guides/README.md → docs/how-to-guides/README.md

@@ -4,7 +4,7 @@ The new editor is highly flexible, like most of WordPress. You can build custom
 
 ## Creating Blocks
 
-The editor is about blocks, and the main extensibility API is the Block API. It allows you to create your own static blocks, [Dynamic Blocks](/docs/howto-guides/block-tutorial/creating-dynamic-blocks.md) ( rendered on the server ) and also blocks capable of saving data to Post Meta for more structured content.
+The editor is about blocks, and the main extensibility API is the Block API. It allows you to create your own static blocks, [Dynamic Blocks](/docs/how-to-guides/block-tutorial/creating-dynamic-blocks.md) ( rendered on the server ) and also blocks capable of saving data to Post Meta for more structured content.
 
 If you want to learn more about block creation, see the [Create a Block tutorial](/docs/getting-started/tutorials/create-block/readme.md) for the best place to start.
 
@@ -24,15 +24,15 @@ You can also filter certain aspects of the editor; this is documented on the [Ed
 
 ## Meta Boxes
 
-Porting PHP meta boxes to blocks or sidebar plugins is highly encouraged, learn how through these [meta data tutorials](/docs/howto-guides/metabox/readme.md).
+Porting PHP meta boxes to blocks or sidebar plugins is highly encouraged, learn how through these [meta data tutorials](/docs/how-to-guides/metabox/readme.md).
 
 See how the new editor [supports existing Meta Boxes](/docs/reference-guides/backward-compatibility/meta-box.md).
 
 ## Theme Support
 
 By default, blocks provide their styles to enable basic support for blocks in themes without any change. Themes can add/override these styles, or rely on defaults.
 
-There are some advanced block features which require opt-in support in the theme. See [theme support](/docs/howto-guides/themes/theme-support.md).
+There are some advanced block features which require opt-in support in the theme. See [theme support](/docs/how-to-guides/themes/theme-support.md).
 
 ## Autocomplete
 

docs/howto-guides/backward-compatibility/meta-box.md → docs/how-to-guides/backward-compatibility/meta-box.md

@@ -1,6 +1,6 @@
 # Meta Boxes
 
-This is a brief document detailing how meta box support works in the block editor. With the superior developer and user experience of blocks, especially once block templates are available, **porting PHP meta boxes to blocks is highly encouraged!** See the [Meta Block tutorial](/docs/howto-guides/metabox/meta-block-1-intro.md) for how to store post meta data using blocks.
+This is a brief document detailing how meta box support works in the block editor. With the superior developer and user experience of blocks, especially once block templates are available, **porting PHP meta boxes to blocks is highly encouraged!** See the [Meta Block tutorial](/docs/how-to-guides/metabox/meta-block-1-intro.md) for how to store post meta data using blocks.
 
 ### Testing, Converting, and Maintaining Existing Meta Boxes
 

docs/howto-guides/block-based-themes/README.md → docs/how-to-guides/block-based-themes/README.md

@@ -12,11 +12,11 @@ This tutorial is up to date as of Gutenberg version 9.1.
 
 ## Table of Contents
 
- 1. [What is needed to create a block-based theme?](/docs/howto-guides/block-based-themes/README.md#what-is-needed-to-create-a-block-based-theme)
- 2. [Creating the theme](/docs/howto-guides/block-based-themes/README.md#creating-the-theme)
- 3. [Creating the templates and template parts](/docs/howto-guides/block-based-themes/README.md#creating-the-templates-and-template-parts)
- 4. [Experimental-theme.json - Global styles](/docs/howto-guides/block-based-themes/README.md#experimental-theme-json-global-styles)
- 5. [Adding blocks](/docs/howto-guides/block-based-themes/block-based-themes-2-adding-blocks.md)
+ 1. [What is needed to create a block-based theme?](/docs/how-to-guides/block-based-themes/README.md#what-is-needed-to-create-a-block-based-theme)
+ 2. [Creating the theme](/docs/how-to-guides/block-based-themes/README.md#creating-the-theme)
+ 3. [Creating the templates and template parts](/docs/how-to-guides/block-based-themes/README.md#creating-the-templates-and-template-parts)
+ 4. [Experimental-theme.json - Global styles](/docs/how-to-guides/block-based-themes/README.md#experimental-theme-json-global-styles)
+ 5. [Adding blocks](/docs/how-to-guides/block-based-themes/block-based-themes-2-adding-blocks.md)
 
 ## What is needed to create a block-based theme?
 
@@ -32,7 +32,7 @@ Each template or template part contains the [block grammar](https://developer.wo
 
 A block based theme requires an `index.php` file, an index template file, a `style.css` file, and a `functions.php` file.
 
-The theme may optionally include an [experimental-theme.json file](/docs/howto-guides/themes/theme-json.md) to manage global styles. You decide what additional templates and template parts to include in your theme.
+The theme may optionally include an [experimental-theme.json file](/docs/how-to-guides/themes/theme-json.md) to manage global styles. You decide what additional templates and template parts to include in your theme.
 
 Templates are placed inside the `block-templates` folder, and template parts are placed inside the `block-template-parts` folder:
 
@@ -377,4 +377,4 @@ Below are the presets and styles combined:
 }
 ```
 
-## [Adding blocks](/docs/howto-guides/block-based-themes/block-based-themes-2-adding-blocks.md)
+## [Adding blocks](/docs/how-to-guides/block-based-themes/block-based-themes-2-adding-blocks.md)