MC-4181: Organize Existing Topics

Making changes based on PR review

Author: bdenham

README.md

@@ -32,40 +32,40 @@ We offer two methods for installing PageBuilder:
 1. [Introduction](docs/getting-started/introduction.md)
 2. [Install Page Builder](docs/getting-started/install-pagebuilder.md)
 3. [Activate Page Builder](docs/getting-started/activate-pagebuilder.md)
-4. [Integrate Page Builder](docs/getting-started/integrate-pagebuilder.md)
 
 ### Customizations
 
 * [Block chooser](docs/customizations/block-chooser.md)
 * [Full-width page layouts](docs/customizations/full-width-page-layouts.md)
 * [Responsive layouts](docs/customizations/responsive-layouts.md)
-* [Custom logic](docs/customizations/custom-logic.md)
+* [Storefront customization](docs/customizations/storefront-customization.md)
 * [Visual selects](docs/customizations/visual-selects.md)
-* [Data configuration](docs/customizations/data-configuration.md)
+* [Additional data configuration](docs/customizations/additional-data-configuration.md)
 * [Product conditions](docs/customizations/product-conditions.md)
 * [Server-side rendered previews](docs/customizations/server-side-rendered-previews.md)
 
 ### How Tos
 
-* [How to add a new content type](docs/how-to/how-to-add-new-content-type.md)
-* [How to add an image uploader](docs/how-to/how-to-add-image-uploader.md)
+* [How to develop a new content type](docs/how-to/how-to-develop-new-content-type.md)
+* [How to develop a container content type](docs/how-to/how-to-develop-container-content-type.md)
+* [How to use the Image Uploader](docs/how-to/how-to-use-image-uploader.md)
 * [How to add inline text editing](docs/how-to/how-to-add-inline-text-editing.md)
 * [How to add a custom toolbar](docs/how-to/how-to-add-custom-toolbar.md)
-* [How to create a custom container](docs/how-to/how-to-create-custom-container.md)
+* [How to convert product attribute fields to use Page Builder](docs/how-to/how-to-convert-product-attributes-to-use-pagebuilder.md)
 * [How to store a component master format as a widget-directive](docs/how-to/how-to-store-master-format-as-widget-directive.md)
 
 ### Reference
 
 * [Architecture](docs/reference/architecture.md)
 * [Events](docs/reference/events.md)
-* [Bindings](docs/reference/bindings.md)
-* [Content type configuration](docs/reference/content-type-configuration.md)
+* [Knockout bindings](docs/reference/knockout-bindings.md)
+* [Configuration](docs/reference/configuration.md)
 * [Master format](docs/reference/master-format.md)
 
 ### Migration
 
-* [Bluefoot data migration](docs/migration/bluefoot-data-migration.md)
-* [Third-party content type migration](docs/migration/third-party-content-type-migration.md)
+* [Migrate from BlueFoot](docs/migration/migrate-from-bluefoot.md)
+* [Migrate custom content types from BlueFoot](docs/migration/migrate-custom-content-types-from-bluefoot.md)
 
 <!-- {% endcomment %} -->
 

docs/_pagebuilder.yml

@@ -11,10 +11,6 @@ pages:
       - label: Activate Page Builder
         url: /page-builder/getting-started/activate-pagebuilder.html
         versionless: true
-
-      - label: Integrate Page Builder
-        url: /page-builder/getting-started/integrate-pagebuilder.html
-        versionless: true
 
   # - label: Developer documentation
   #   url: /page-builder/developer-documentation.html
@@ -35,16 +31,16 @@ pages:
         url: /page-builder/customizations/responsive-layouts.html
         versionless: true
 
-      - label: Custom logic
-        url: /page-builder/customizations/custom-logic.html
+      - label: Storefront customization
+        url: /page-builder/customizations/storefront-customization.html
         versionless: true
 
       - label: Visual selects
         url: /page-builder/customizations/visual-selects.html
         versionless: true
 
-      - label: Data configuration
-        url: /page-builder/customizations/data-configuration.html
+      - label: Additional data configuration
+        url: /page-builder/customizations/additional-data-configuration.html
         versionless: true
 
       - label: Product conditions
@@ -58,12 +54,16 @@ pages:
   - label: How Tos
     versionless: true
     children:
-      - label: How to add a new content type
-        url: /page-builder/how-to/how-to-add-new-content-type.html
+      - label: How to develop a new content type
+        url: /page-builder/how-to/how-to-develop-new-content-type.html
+        versionless: true
+
+      - label: How to develop a container content type
+        url: /page-builder/how-to/how-to-develop-container-content-type.html
         versionless: true
 
-      - label: How to add an Image Uploader
-        url: /page-builder/how-to/how-to-add-image-uploader.html
+      - label: How to use the Image Uploader
+        url: /page-builder/how-to/how-to-use-image-uploader.html
         versionless: true
 
       - label: How to add inline text editing
@@ -73,9 +73,9 @@ pages:
       - label: How to add a custom toolbar
         url: /page-builder/how-to/how-to-add-custom-toolbar.html
         versionless: true
-      
-      - label: How to create a custom container
-        url: /page-builder/how-to/how-to-create-custom-container.html
+
+      - label: How to convert product attribute fields to use Page Builder
+        url: /page-builder/how-to/how-to-convert-product-attributes-to-use-pagebuilder.html
         versionless: true
 
       - label: How to store a component's master format as a widget-directive
@@ -97,12 +97,12 @@ pages:
         url: /page-builder/reference/events.html
         versionless: true
 
-      - label: Bindings
-        url: /page-builder/reference/bindings.html
+      - label: Knockout bindings
+        url: /page-builder/reference/knockout-bindings.html
         versionless: true
 
-      - label: Content type configuration
-        url: /page-builder/reference/content-type-configuration.html
+      - label: Configuration
+        url: /page-builder/reference/configuration.html
         versionless: true
 
       - label: Master format
@@ -112,12 +112,12 @@ pages:
   - label: Migration to Page Builder
     versionless: true
     children:
-      - label: BlueFoot data migration
-        url: /page-builder/migration/bluefoot-data-migration.html
+      - label: Migrate from BlueFoot
+        url: /page-builder/migration/migrate-from-bluefoot.html
         versionless: true
 
-      - label: Third-party content type migration
-        url: /page-builder/migration/third-party-content-type-migration.html
+      - label: Migrate custom content types from BlueFoot
+        url: /page-builder/migration/migrate-custom-content-types-from-bluefoot.html
         versionless: true
 
   - label: Contribution guide

docs/customizations/data-configuration.md renamed to docs/customizations/additional-data-configuration.md

@@ -1,4 +1,4 @@
-# Data configuration
+# Additional data configuration
 
 <!-- {% raw %} -->
 

docs/customizations/custom-logic.md renamed to docs/customizations/storefront-customization.md

@@ -1,12 +1,12 @@
-# Custom logic <!-- omit in toc -->
+# Storefront customization <!-- omit in toc -->
 
 <!-- {% raw %} -->
 You can customize PageBuilder content types by adding your own logic on the frontend.
 
 To add custom logic to content types:
 
 - [Create a JavaScript widget](#create-a-javascript-widget)
-- [Add XML configuration to load it on the frontend](#add-xml-configuration-to-load-it-on-the-frontend)
+- [Add XML configuration](#add-xml-configuration)
 
 ## Create a JavaScript widget
 
@@ -48,9 +48,9 @@ define([
 
 ```
 
-## Add XML configuration to load it on the frontend
+## Add XML configuration
 
-Add XML configuration to load it on the frontend, and on the stage, so that you can preview content inside both the block and dynamic block content types.
+The XML configuration loads the widget on the frontend, and on the stage, so that you can preview content inside both the block and dynamic block content types.
 
 Add the following configuration to the `etc/di.xml` file in your custom module directory:
 

docs/getting-started/introduction.md

@@ -1,8 +1,8 @@
 # Introduction
 
-PageBuilder is a Content Management System(CMS) module for Magento 2.3 and above.
+PageBuilder is a module that provides a visual way to build content within the Admin editor for Magento 2.3 and above.
 It replaces the default WYSIWYG Editor in the Admin area with a highly configurable drag-and-drop editing system.
 
-This page should serve as a guide to introducing what will be covered in this documentation.
+[This page will introduce Page Builder by providing infographics, screenshots, and descriptions for what Page Builder is and how it works.]
 
 TBW

docs/how-to/how-to-add-custom-toolbar.md

@@ -4,7 +4,8 @@
 
 ## What's in this topic
 
-This document outlines how to add a custom toolbar in Page Builder. It's a simplified/lightweight version of a WYSIWYG:
+This document outlines how to implement the inline editing toolbar for any content type. This feature is used within the heading to allow for easy modification of the heading type and alignment. It can be used within your content types to quickly change common things without needing to open the full editor.
+
 ![Page Builder toolbar](images/toolbar.png)
 
 ## Overview

docs/getting-started/integrate-pagebuilder.md renamed to docs/how-to/how-to-convert-product-attributes-to-use-pagebuilder.md

@@ -1,4 +1,4 @@
-# Integrate Page Builder
+# How to convert product attribute fields to use Page Builder
 
 <!-- {% raw %} -->
 

docs/how-to/how-to-create-custom-container.md renamed to docs/how-to/how-to-develop-container-content-type.md

@@ -1,4 +1,4 @@
-# How to create a custom content type container
+# How to develop a container content type
 
 <!-- {% raw %} -->
 This tutorial takes you through the process of creating a module with the name `VendorName_CustomContainer`.

docs/how-to/how-to-add-new-content-type.md renamed to docs/how-to/how-to-develop-new-content-type.md

@@ -1,4 +1,4 @@
-# How to add a new content type
+# How to develop a new content type
 
 <!-- {% raw %} -->
 

docs/how-to/how-to-add-image-uploader.md renamed to docs/how-to/how-to-use-image-uploader.md

@@ -1,4 +1,4 @@
-# How to add an Image Uploader <!-- omit in toc -->
+# How to use the Image Uploader <!-- omit in toc -->
 
 <!-- {% raw %} -->