misc readme changes (#29)

* misc readme changes

* Update DEPLOY_MODEL.md

moved protocol onto same line as ports to match ui

* Update README.md

* Update README.md

nit

* Update deploy.json

Fixed example endpoints

* Update README.md

grammar

Author: rhagarty

.bluemix/deploy.json

@@ -23,7 +23,7 @@
             "pattern": "\\S"
         },
         "dev-ml-endpoint": {
-            "description": "e.g. https://max-image-caption-generator.mybluemix.net/model/predict",
+            "description": "e.g. http://170.0.0.1:5000",
             "type": "string"
         }
     },
@@ -85,8 +85,8 @@
             "type": "text",
             "readonly": false,
             "title": "Image Caption Generator Model API Endpoint",
-            "description": "e.g. https://max-image-caption-generator.mybluemix.net/model/predict",
+            "description": "e.g. http://170.0.0.1:5000",
             "key": "dev-ml-endpoint"
         }
     ]
-}
+}

DEPLOY_MODEL.md

@@ -6,10 +6,12 @@
 
    ![Create Cluster](doc/source/images/create-cluster.png)
 
-2. (Optional Step) The instructions to install the command line tools are optional and not required to deploy the model using this tutorial. You may choose to install them while waiting for the cluster to be created, if you wish to do so.
+2. (Optional Step) The instructions to install the command line tools are optional and not required to deploy the model using this tutorial. While not required, you may choose to install them while waiting for the cluster to be created.
 
 3. On your cluster dashboard, select `Worker Nodes` in the sidebar and take note of the `Public IP Address` for the node.
 
+> Note: The IP address will not be displayed until the cluster is fully deployed.
+
    ![Worker IP](doc/source/images/worker-public-ip.png)
 
 4. Click the `Kubernetes Dashboard` button to open the dashboard. Hit the `+ Create` button in the top right corner. Go to `Create an app`.
@@ -19,7 +21,7 @@
     Container image: codait/max-image-caption-generator:latest
     Number of pods: 1
     Service: External
-    Port: 5000 | Target Port: 5000
+    Port: 5000 | Target Port: 5000 | Protocol: TCP
    ```
    Then click `Deploy`
 

README.md

@@ -74,25 +74,24 @@ If you already have a model API endpoint available you can skip this process.
 
 ### Deploy the Web App
 
-1. Press the ``Deploy to IBM Cloud`` button. If you do not have an IBM Cloud account yet, you will need to create one.
+1. Press the `Deploy to IBM Cloud` button. If you do not have an IBM Cloud account yet, you will need to create one.
 
     [![Deploy to IBM Cloud](https://bluemix.net/deploy/button.png)](https://bluemix.net/deploy?repository=https://github.com/IBM/MAX-Image-Caption-Generator-Web-App)
 
-2. Click `Delivery Pipeline` and fill in the form with Image Caption Generator API endpoint deployed above then
-click on ``Create``.
+2. Click `Delivery Pipeline` and fill in the form with the Image Caption Generator API endpoint deployed above, then click on `Create`.
 
-    > e.g. `https://max-image-caption-generator.mybluemix.net/model/predict`
+    > The format for this entry should be `http://170.0.0.1:5000`
 
     ![Create App](doc/source/images/ibm-cloud-form.png)
 
-3. In Toolchains, click on ``Delivery Pipeline`` to watch while the app is deployed. Once deployed, the app can be
-viewed by clicking ``View app``.
+3. In Toolchains, click on `Delivery Pipeline` to watch while the app is deployed. Once deployed, the app can be
+viewed by clicking `View app`.
 
     ![Delivery Pipeline](doc/source/images/ibm-cloud-deploy.png)
 
 ## Run Locally
 
-> NOTE: These steps are only needed when running locally instead of using the ``Deploy to IBM Cloud`` button.
+> NOTE: These steps are only needed when running locally instead of using the `Deploy to IBM Cloud` button.
 
 #### Setting up the MAX Model