MC-4181: Organize Existing Topics

Rename topics, files, and reorganized TOC for devdocs inclusion

Author: bdenham

.gitignore

@@ -4,4 +4,5 @@
 **.d.js
 /dev/tests/acceptance/vendor
 static-error-log.xml
-.DS_Store
+.DS_Store
+.vscode

CONTRIBUTING.md

@@ -1,46 +1,5 @@
 # Contributing to Magento 2 code
-<!-- {% comment %} -->
-## Navigation
 
-1. [Introduction]
-2. [Installation guide]
-3. **Contribution guide**
-    1. [Overview](#overview)
-    1. [Contribution requirements](#contribution-requirements)
-    1. [Contribution process](#contribution-process)
-    1. [Code of Conduct](#code-of-conduct)
-4. [Developer documentation]
-5. [Roadmap and known issues]
-6. [How to create custom PageBuilder content type container]
-
-[Introduction]: introduction.md
-[Contribution guide]: CONTRIBUTING.md
-[Installation guide]: install.md
-[Developer documentation]: developer-documentation.md
-[Architecture overview]: architecture-overview.md
-[BlueFoot to PageBuilder data migration]: bluefoot-data-migration.md
-[Third-party content type migration]: new-content-type-example.md
-[Iconography]: iconography.md
-[Add image uploader to content type]: image-uploader.md
-[Module integration]: module-integration.md
-[Additional data configuration]: custom-configuration.md
-[Content type configuration]: content-type-configuration.md
-[How to add a new content type]: how-to-add-new-content-type.md
-[Events]: events.md
-[Bindings]: bindings.md
-[Master format]: master-format.md
-[Visual select]: visual-select.md
-[Reuse product conditions in content types]: product-conditions.md
-[Store component master format as widget directive]: widget-directive.md
-[Use the block chooser UI component]: block-chooser-component.md
-[Use the inline text editing component]: inline-editing-component.md
-[Render a backend content type preview]: content-type-preview.md
-[Custom Toolbar]: toolbar.md
-[Full width page layouts]: full-width-page-layouts.md
-[Add image uploader to content type]: image-uploader.md
-[Roadmap and Known Issues]: roadmap.md
-[How to create custom PageBuilder content type container]: how-to-create-custom-content-type-container.md
-<!-- {% endcomment %} -->
 ## Overview
 
 Contributions to the Magento 2 codebase are done using the fork & pull model.
@@ -50,18 +9,17 @@ Contributions can take the form of new components/features, changes to existing
 
 The Magento 2 development team will review all issues and contributions submitted by the community of developers in the first in, first out order. During the review we might require clarifications from the contributor. If there is no response from the contributor for two weeks, the issue is closed.
 
-
 ## Contribution requirements
 
 1. Contributions must adhere to [Magento coding standards](http://devdocs.magento.com/guides/v2.0/coding-standards/bk-coding-standards.html).
 2. Pull requests (PRs) must be accompanied by a meaningful description of their purpose. Comprehensive descriptions increase the chances of a pull request to be merged quickly and without additional clarification requests.
 3. Commits must be accompanied by meaningful commit messages.
 4. PRs which include bug fixing, must be accompanied with step-by-step description of how to reproduce the bug.
-3. PRs which include new logic or new features must be submitted along with:
-* Unit/integration test coverage where applicable.
-* Updated documentation in the `docs` directory at the root level.
-1. For large features or changes, please [open an issue](https://github.com/magento/magento2/issues) and discuss first. This may prevent duplicate or unnecessary effort, and it may gain you some additional contributors.
-2. All automated tests are passed successfully locally. After PR submitted Magento team will run builds on continuous integration environment.
+5. PRs which include new logic or new features must be submitted along with:
+    * Unit/integration test coverage where applicable.
+    * Updated documentation in the `docs` directory at the root level.
+6. For large features or changes, please [open an issue](https://github.com/magento/magento2/issues) and discuss first. This may prevent duplicate or unnecessary effort, and it may gain you some additional contributors.
+7. All automated tests are passed successfully locally. After PR submitted Magento team will run builds on continuous integration environment.
 
 ## Contribution process
 

README.md

@@ -9,72 +9,77 @@ The PageBuilder Early Access Program (EAP) gives partners the following perks:
 * Explore PageBuilder extension points to build custom modules and integrations for 3rd party services, such as Facebook, Instagram, etc.
 * Try out PageBuilder customization options and extend its functionality beyond its default features.
 * Preview PageBuilder to prepare a migration plan from BlueFoot 1.0 to PageBuilder.
- 
+
 **Note:**
 *This program should not be used to design and launch a production website using early code.*
 
 ## Installation
 
 We offer two methods for installing PageBuilder:
 
-* As a [Composer package] - use this option if you do not plan to contribute to the PageBuilder code repository 
-* Using the [GitHub repository] - use this option to install PageBuilder from the GitHub repository and contribute to the code 
+* As a [Composer package] - use this option if you do not plan to contribute to the PageBuilder code repository.
+* Using the [GitHub repository] - use this option to install PageBuilder from the GitHub repository and contribute to the code.
+
+[Composer package]: docs/install-pagebuilder.md#composer-installation
+[GitHub repository]: docs/install-pagebuilder.md#github-installation
 
-[Composer package]: docs/install.md#composer-installation
-[GitHub repository]: docs/install.md#github-installation
+<!-- {% comment %} -->
 
 ## Developer documentation
 
-This project repository contains PageBuilder developer documentation on the following topics:
-
-1. [Architecture overview]
-1. [BlueFoot to PageBuilder data migration]
-1. [Third-party content type migration]
-1. [Iconography]
-1. [Module integration]
-1. [Additional data configuration]
-1. [Content type configuration]
-1. [How to add a new content type]
-1. [Events]
-1. [Bindings]
-1. [Master format]
-1. [Visual select]
-1. [Custom Toolbar]
-
-[Architecture overview]: docs/architecture-overview.md
-[BlueFoot to PageBuilder data migration]: docs/bluefoot-data-migration.md
-[Third-party content type migration]: docs/new-content-type-example.md
-[Iconography]: docs/iconography.md
-[Module integration]: docs/module-integration.md
-[Additional data configuration]: docs/custom-configuration.md
-[Content type configuration]: docs/content-type-configuration.md
-[How to add a new content type]: docs/how-to-add-new-content-type.md
-[Events]: docs/events.md
-[Bindings]: docs/bindings.md
-[Master format]: docs/master-format.md
-[Visual select]: docs/visual-select.md
-[Custom Toolbar]: docs/toolbar.md
+### Getting Started
 
-## Contribute to 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)
+* [Visual selects](docs/customizations/visual-selects.md)
+* [Data configuration](docs/customizations/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 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 store a component master format as a widget-directive](docs/how-to/how-to-store-master-format-as-widget-directive.md)
 
-We appreciate any and all contributions to PageBuilder. 
-A good place to start is by looking at our [features roadmap] and list of [known issues].
+### Reference
 
-If you are interested in contributing to this repository, please see our [Contribution Guide].
+* [Architecture](docs/reference/architecture.md)
+* [Events](docs/reference/events.md)
+* [Bindings](docs/reference/bindings.md)
+* [Content type configuration](docs/reference/content-type-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)
+  
+<!-- {% endcomment %} -->
+
+## Contribute to PageBuilder
+
+We appreciate any and all contributions to PageBuilder. If you are interested in contributing to this repository, please see our [Contribution Guide].
 
 [Contribution Guide]: CONTRIBUTING.md
-[features roadmap]: docs/roadmap.md#planned-features-and-functionality
-[known issues]: docs/roadmap.md#known-issues
 
 ## PageBuilder updates from the Magento core team
 
 The PageBuilder team updates the code every 2 weeks.
 **These changes may introduce breaking changes.**
 
-To help you prepare for these changes, we are publishing a [roadmap] of features and issues that we are going to work on in the following months.
-
-[roadmap]: docs/roadmap.md
-
 ## Provide feedback
 
 We want to hear what you think of PageBuilder!