MAGECLOUD-1802: Update readme (#299)

Author: hguthrie

README.md

@@ -1,52 +1,90 @@
-# Magento 2.3.0 Magento Commerce (Cloud)
+# Magento 2.3.0 Magento Commerce Cloud
 
-This sample repository helps you deploy a Magento 2.3.0 Enterprise Edition (EE) instance in the cloud. You must be a licensed user of Magento Magento Commerce (Cloud) to use the example in this repository.
+This repository contains a sample Magento Commerce (on-premise) version 2.3.0 instance for you to deploy in the cloud. You must have an active Magento Commerce Cloud user license to use the example in this repository.
 
-This example is based on using the Composer to load dependencies and get the Magento vendor folders.
+The example requires the use of [Composer](https://getcomposer.org/doc/) to load and manage dependencies and Magento vendor folders.
 
-## Create an authorization file
-To enable you to install and update the Magento software, you must have an `auth.json` file in your project's root directory. `auth.json` contains your Magento EE [authorization credentials](http://devdocs.magento.com/guides/v2.2/install-gde/prereq/connect-auth.html).
+-  [Authentication](#authentication)
+    -  [Authenticating in Docker](#authenticating-in-docker)
+-  [Repository structure](#repository-structure)
+-  [Developer documentation](#developer-documentation)
 
-In some cases, you might already have `auth.json` so check to see if it exists and has your authentication credentials before you create a new one.
+## Authentication
 
-To create a new `auth.json` in the event you don't have one:
+You must have an authentication key to access the Magento Commerce repository and to enable install and update commands for your Magento Commerce Cloud project. 
+The following method is best to prevent accidental exposure of credentials, such as pushing an `auth.json` file to a public repository. If you plan to use Docker for your local development, then jump to the [Authenticating in Docker](#authenticating-in-docker) section.
 
-1.  Copy the provided sample using the following command:
+To add authentication keys using an environment variable:
 
-        cp auth.json.sample auth.json
-2.  Open `auth.json` in a text editor.
-3.  Replace `<public-key>` and `<private-key>` with your authentication credentials.
+1.  In the _Project Web UI_, click the configuration icon in the upper left corner.
 
-    See the following example:
+1.  In the _Configure Project_ view, click the **Variables** tab.
 
-        "http-basic": {
-           "repo.magento.com": {
-              "username": "<public-key>",
-              "password": "<private-key>"
-            }
+1.  Click **Add Variable**.
+
+1.  In the _Name_ field, enter `env:COMPOSER_AUTH`.
+
+1.  In the _Value_ field, add the following and replace `<public-key>` and `<private-key>` with your Magento Commerce Cloud authentication credentials.
+
+    ```json
+    {
+       "http-basic": {
+          "repo.magento.com": {
+          "username": "<public-key>",
+          "password": "<private-key>"
+        }
+      }
+    }
+    ```
+
+1.  Select **Visible during build** and deselect **Visible at run**.
+
+1.  Click **Add Variable**.
+
+See [Adding Magento authentication keys](https://devdocs.magento.com/guides/v2.2/cloud/setup/first-time-setup-import-prepare.html#auth-json).
+
+### Authenticating in Docker
+
+You must have an `auth.json` file that contains your Magento Commerce authorization credentials in your Magento Commerce Cloud root directory.
+
+1.  Using a text editor, create an `auth.json` file and save it in your Magento root directory.
+
+1.  Replace <public-key> and <private-key> with your Magento Commerce authentication credentials.
+
+    ```json
+    {
+      "http-basic": {
+        "repo.magento.com": {
+          "username": "<public-key>",
+          "password": "<private-key>"
         }
-3.  Save your changes to `auth.json` and exit the text editor.
+      }
+    }
+    ```
+
+1.  Save your changes to `auth.json` file and exit the text editor.
+
+To use Docker for local development, see [Launching a Docker configuration](https://devdocs.magento.com/guides/v2.2/cloud/docker/docker-config.html).
 
 ## Repository structure
-Here are the specific files for this example to work on Magento Magento Commerce (Cloud):
 
-```
+The following is a list of the specific files required for this example to work in the Magento Commerce Cloud:
+
+```bash
 .magento/
-         /routes.yaml
-         /services.yaml
+        /routes.yaml
+        /services.yaml
 .magento.app.yaml
 auth.json
 composer.json
 magento-vars.php
 php.ini
 ```
 
-`.magento/routes.yaml` redirects `www` to the naked domain, and that the application that will be serving HTTP is named `php`.
-
-`.magento/services.yaml` sets up a MySQL instance, plus Redis and Solr. 
-
-``composer.json`` fetches the Magento Enterprise Edition and some configuration scripts to prepare your application.
+-  `.magento/routes.yaml`—redirects `www` to the naked domain and `php` application to serve HTTP.
+-  `.magento/services.yaml`—sets up a MySQL instance, including Redis and ElasticSearch. 
+-  `composer.json`—fetches the Magento Enterprise Edition and configuration scripts to prepare your application.
 
-## Documentation
-For more details, see our [Magento Enterprise Cloud Guide](http://devdocs.magento.com/guides/v2.2/cloud/bk-cloud.html). 
+## Developer documentation
 
+See the [Magento Commerce Cloud Guide](http://devdocs.magento.com/guides/v2.2/cloud/bk-cloud.html).