Merge pull request #21 from magento-devdocs/MAGEDOC-3558

MAGEDOC-3558: Docs for changed repo access

Author: bdenham

docs/getting-started/install-pagebuilder.md

@@ -1,39 +1,94 @@
 # Install Page Builder
 
-## Prerequisites
+How you install the pre-release version of Page Builder depends on whether you are a member of the Early Adopters Program (EAP):
 
-You must be an active member in the Page Builder EAP program and have submitted your MAGEID to be provided access to the Page Builder composer packages through `repo.magento.com`. If you have not done so, or are experiencing problems please contact us at `[email protected]`. 
+- **All Partners** (not EAP members) must use the [GitHub installation](#githubInstructions).
+- **EAP Members** can install using the [Composer installation](#composerInstallation).
 
-## Installation steps
+## Prerequisite for both installations
 
-{: .bs-callout .bs-callout-info }
-If you have had a previous version of Magento 2.3.0 or Page Builder installed you may need to clear your composer cache (`composer clearcache`) to ensure the latest packages of both versions are installed.
+Magento 2.3+ Commerce -- Use the installation instructions from the [DevDocs installation guide](https://devdocs.magento.com/guides/v2.3/install-gde/bk-install-guide.html). 
+
+## **All Partners**: GitHub Installation {#githubInstructions}
+
+Partners who are not members of the Early Adopters Program (EAP) must install the pre-release version of Page Builder by cloning the Page Builder GitHub repository (https://github.com/magento/magento2-page-builder) into a development instance of Magento. 
+Before installing Page Builder, make sure you have:
+
+* A local development installation of Magento Commerce 2.3.0
+* Access to the Page Builder repository
+* [npm package manager](https://www.npmjs.com/get-npm)
 
-1. Upgrade an existing project to Magento 2.3.0 Commerce or install a fresh copy. Instructions for installation can be found [here](https://devdocs.magento.com/guides/v2.3/install-gde/bk-install-guide.html). **Use the MAGEID assigned to you when you signed up to the program.**
+1. Clone the Page Builder repos into the root directory of your Magento Commerce installation:
 
-2. Ensure your composer has `minimum-stability` set to `beta` as follows:
+    ```bash
+    git clone https://github.com/magento/magento2-page-builder
+    git clone https://github.com/magento/magento2-page-builder-ee
     ```
-    composer config minimum-stability beta
+
+2. From the root directory of your Magento Commerce installation, use the `dev/tools/build-ee.php` script to symlink `magento2-page-builder` and `magento2-page-builder-ee` repos into your Magento Commerce installation:
+
+    ```bash
+    php dev/tools/build-ee.php --command=link --ee-source="magento2-page-builder" --ce-source="."
+    php dev/tools/build-ee.php --command=link --ee-source="magento2-page-builder-ee" --ce-source="."
     ```
+    
+    The results should look like this:
+    
+    ![Symlinks to Page Builder](../images/symlinked-pagebuilder.png)
+
+3. Enable the Page Builder module using the following command:
 
-3. Navigate to the root of the project and require the `magento/module-page-builder-commerce` package:
+    ```bash
+    bin/magento setup:upgrade
     ```
+
+### Updating GitHub installation
+
+When a new version of Page Builder is available, simply pull down the latest versions from `magento/magento2-page-builder` and `magento/magento2-page-builder-ee`.
+
+### Installing Node.js dependencies
+
+If you plan to contribute to Page Builder, you need to install Node.js dependencies to compile TypeScript.
+
+Navigate to the `pagebuilder` directory and install Page Builder dependencies using the following command:
+
+```bash
+cd pagebuilder && npm install
+```
+
+After installing the npm packages, you can run `npm run start`. This command watches for changes to your TypeScript files, compiles, and checks for errors.
+
+## **EAP Participants Only**: Composer Installation {#composerInstallation}
+
+To use the Composer installation described below, you must be an active member in the Page Builder EAP program and have submitted your MAGEID to get access to the Page Builder Composer packages through `repo.magento.com`. 
+If you are experiencing problems _as an EAP member_, please contact us at `[email protected]`.
+
+{: .bs-callout .bs-callout-info }
+If you already have Magento 2.3.0 or Page Builder installed, clear your composer cache (`composer clearcache`) before you install the latest packages.
+
+1. Ensure your composer has `minimum-stability` set to `beta`:
+
+    ```bash
+    composer config minimum-stability beta
+    ```
+
+2. Navigate to the root of the project and require the `magento/module-page-builder-commerce` package:
+
+    ```bash
     composer require magento/page-builder-commerce:^1.0.0
     ```
 
-4. Enable the module within Magento:
-    ``` sh
+3. Enable the module within Magento:
+
+    ``` bash
     bin/magento setup:upgrade
     ```
 
-5. Activate Page Builder from the Admin UI as described in [Activate Page Builder](activate-pagebuilder.md).
-
-## Updating
+4. Activate Page Builder from the Admin UI as described in [Activate Page Builder](activate-pagebuilder.md).
 
-We plan to release a new version of Page Builder beta every week.
-This can be install by completing a `composer update` within your project.
+### Updating Composer installation
 
-## Troubleshooting
+You can install updates by completing a `composer update` within your project.
 
 ### Composer installation issues
 

docs/images/symlinked-pagebuilder.png

@@ -1,10 +1,13 @@
-# PageBuilder Early Adopters Program
+# Page Builder pre-release access
 
-The Page Builder Early Adopters Program (EAP) gives partners the following perks:
- 
-* Explore extension points to build custom modules and integrations for 3rd party services, such as Facebook and Instagram.
-* Try out customization options and extend its functionality beyond its default features.
-* Preview to prepare a migration plan from BlueFoot 1.0 to PageBuilder.
+Pre-release access to Page Builder is opened to all Magento Partners with *no support* from Magento.
+Use this access to:
+
+- Explore extension points to build custom modules and integrations for 3rd party services, such as Facebook and Instagram.
+- Try out customization options and extend its functionality beyond its default features.
+- Preview to prepare a migration plan from BlueFoot 1.0 to Page Builder.
+
+Should you find an issue in Page Builder functionality, please report it on GitHub.
 
 ## Installation
 
@@ -77,14 +80,4 @@ See [Install Page Builder](getting-started/install-pagebuilder.md)
 
 ## Contribute to Page Builder
 
-We appreciate any and all contributions to PageBuilder. If you are interested in contributing to this repository, please see our [Contribution guide](https://github.com/magento/magento2-page-builder/blob/develop/CONTRIBUTING.md).
-
-## Page Builder updates from the Magento core team
-
-We will push new beta releases once a week, including work from the backlog. We don't expect any large breaking changes, but we will communicate them to you if the need arises.
-
-## Contact us
-
-To participate in technical discussions and ask questions, join us in [Slack], where a number of Page Builder team members are present.
-
-[Slack]: https://magentocommeng.slack.com/messages/GANS1R4C9
+We appreciate any and all contributions to PageBuilder. If you are interested in contributing to this repository, please see our [Contribution guide](https://github.com/magento/magento2-page-builder/blob/develop/CONTRIBUTING.md).