Merge pull request #57 from ibm-watson-data-lab/i16

I16

Author: bradley-holt

README.md

@@ -28,7 +28,6 @@ When the reader has completed this Code Pattern, they will understand how to:
 
 * [Cloudant NoSQL DB](https://console.ng.bluemix.net/catalog/services/cloudant-nosql-db): A fully managed data layer designed for modern web and mobile applications that leverages a flexible JSON schema.
 
-
 ## Featured technologies
 
 * [PouchDB](https://pouchdb.com/) - an in-browser database that can replicate to and from a remote Apache CouchDB or IBM Cloudant database.
@@ -40,23 +39,21 @@ When the reader has completed this Code Pattern, they will understand how to:
 
 To see this app in action without installing anything, simply visit https://ibm-watson-data-lab.github.io/shopping-list-react-pouchdb in a web browser or on a mobile device.
 
-# Steps (UPDATE AS NEEDED)
+# Steps
 
 * [Deploy to IBM Cloud](#deploy-to-bluemix) **OR** [Run locally](#run-locally)
 * [Database and replication setup](#database-and-replication-setup)
 
-## Deploy to IBM Cloud (UPDATE AS NEEDED)
+## Deploy to IBM Cloud
 
-[![Deploy to IBM Cloud](https://metrics-tracker.mybluemix.net/stats/5c5df69e10058d49cdc1f4d2fc63ce31/button.svg)](https://bluemix.net/deploy?repository=https://github.com/ibm-watson-data-lab/shopping-list-react-pouchdb)
+[![Deploy to IBM Cloud](https://metrics-tracker.mybluemix.net/stats/3490d3ff2913824363808c07a6645ab5/button.svg)](https://bluemix.net/deploy?repository=https://github.com/ibm-watson-data-lab/shopping-list-react-pouchdb)
 
 1. Press the above ``Deploy to IBM Cloud`` button and then click on ``Deploy``.
 
 1. In Toolchains, click on Delivery Pipeline to watch while the app is deployed. Once deployed, the app can be viewed by clicking `View app`.
 
 1. To see the app and services created and configured for this code pattern, use the IBM Cloud dashboard. The app is named `shopping-list-react-pouchdb` with a unique suffix. The following services are created and easily identified by the `sljsp` prefix:
-
-
- * sljsp-CloudantNoSQLDB
+ * sljsp-CloudantNoSQLDB
 
 ## Run locally
 
@@ -73,27 +70,20 @@ Clone the `shopping-list-react-pouchdb` locally. In a terminal, run:
 
 ```
 $ git clone https://github.com/ibm-watson-data-lab/shopping-list-react-pouchdb
+$ cd shopping-list-react-pouchdb
 ```
 
-
-### 3. Run the server
-
-This command serves the app at `http://127.0.0.1:3000` and provides basic URL routing for the app:
-
- npm start
-
-=======
 ### 2. Install the dependencies
 
 To install the dependencies, run the command:
 
- npm install
+ $ npm install
 
 ### 3. Run the app
 
-This command starts the app:
+This command serves the app at `http://127.0.0.1:3000` and provides basic URL routing for the app:
 
- npm start
+ $ npm start
 
 ### 4. Create a Cloudant or CouchDB service
 
@@ -119,36 +109,42 @@ To provision a managed Cloudant NoSQL DB
 
 Tip: Select the **Manage** tab and click **Launch** to open the Cloudant dashboard and manage the service instance.
 
-## Database and replication setup (UPDATE AS NEEDED)
+## Database and replication setup
 1. [Create the remote database](#1-create-the-remote-database)
 1. [Enable CORS](#2-enable-cors)
 1. [Set the replication target](#3-set-the-replication-target)
 
-### 1. Create the remote database (UPDATE AS NEEDED)
+### 1. Create the remote database
+
+* Use the Cloudant or CouchDB dashboard to create a database.
 
-Use your Cloudant or CouchDB dashboard to create a database. Select the Databases icon on the left and then use the `Create Database` button to create the "shopping-list" database.
+* Select the Databases tab on the left and then use the `Create Database` button to create the "shopping-list" database.
 The Shopping List app can be used locally before the database exists, but cannot sync
 until the remote database is completed.
 
-![](doc/source/images/create_db.png)
+ ![Create shopping-list database](doc/source/images/create_db.png)
 
-### 2. Enable CORS (UPDATE AS NEEDED)
+### 2. Enable CORS
 
-Cross-Origin Resource Sharing (CORS) needs to be enabled. Use your Cloudant or CouchDB dashboard to enable it. The CORS options are under the account settings or config depending on your version. Enable CORS and restrict the domain as needed for security.
+* Open the Cloudant or CouchDB dashboard to enable Cross-Origin Resource Sharing (CORS). 
 
-![](doc/source/images/enable_cors.png)
+* Select the Account Settings (or config) tab and open the **CORS** tab.
 
-### 3. Set the replication target (UPDATE AS NEEDED)
+* Enable CORS and restrict the domain as needed for security.
 
-Run the Shopping List app and use the `Replicator` form to enter your Database URL.
-If you use the IBM Cloud Cloudant URL taken from the service credentials as described above, the URL includes user and password GUIDs.
+ ![Enable CORS](doc/source/images/enable_cors.png)
+
+### 3. Set the replication target
+
+Run the Shopping List app and use the *Settings* form to enter your database URL.
+If you use the IBM Cloud Cloudant URL taken from the service credentials as described above, the URL includes user name and password.
 
 Add `/shopping-list` to the URL to connect to the database that you created.
 
-![](doc/source/images/replicator.png)
+![Configure replication in app](doc/source/images/replicator.png)
 
 <!--Edit as appropriate, update screenshot-->
-# Using the app (UPDATE AS NEEDED)
+# Using the app
 
 The app allows you to create a shopping list by clicking on the plus sign. Click on the list to see its items. Then, you can add items to the list by clicking the plus sign. There is a checkbox to allow you to mark the items complete as you buy load up your cart.
 
@@ -158,8 +154,6 @@ When you go online and have the database and CORS enabled and the Replication Ta
 
 ![](doc/source/images/shopping_lists.png)
 
-## Running the app (UPDATE AS NEEDED)
-
 ## Running the tests (UPDATE AS NEEDED)
 
 ## Deploying to GitHub Pages (UPDATE AS NEEDED)
@@ -188,4 +182,4 @@ To disable tracking, simply remove `node log &&` from the `package.json` file.
 * [Material UI](http://www.material-ui.com/) 
 
 # License
-[Apache 2.0](LICENSE)
+[Apache 2.0](LICENSE)