Documentation updates

Author: kilna

README.md

@@ -22,15 +22,35 @@ In order to use this, you will have your project derive its own Dockerfile based
 
 ## Usage
 
-An example of a usable project can be found in the [example/](./example/) directory.  This lambda function in [service.py](./example/service.py) takes a JSON input file like the one provided in [event.json](./example/event.json) and returns an ASCII-art version of the text described in it.  The provided [Dockerfile](./example/Dockerfile) derives from this image and loads the current workspace into the image at the path _/lambda_, then installs dependencies from the [requirements.txt](./example/requirements.txt) file.  
+An example of a usable project can be found in the [example/](./example/) directory.  The lambda function in [service.py](./example/service.py) takes a JSON input file like the one provided in [event.json](./example/event.json) and returns an ASCII-art version of the text described in it.  The [Dockerfile](./example/Dockerfile) derives from python-lambda as a base image, and loading the example directory contents into the image at the path _/lambda_, then installs dependencies from the [requirements.txt](./example/requirements.txt) file.  
 
-To build a docker image called _example-lambda-image_ with the example lambda function in it, run:
+### Building a Derived Docker Image
+
+To build a docker image from the provided [exmaple/](./exmaple) called _example-lambda-image_ with the ASCII-art lambda function in it, run:
 
 ```
 $ cd example/
 $ docker build --tag example-lambda-image .
 ```
 
+Any time you make changes to the example project, you'll need to re-run the `docker build` command above, or you can investigate using docker volumes to sync local filesystem changes into the container. 
+
+#### Switching Python Versions
+
+The example [Dockerfile](./example/Dockerfile) uses a _:latest_ docker tag in the FROM line, which is currently the same as _:3.6_, but if you wish to use a different Python version you can change this. Supported Python versions are 2.7, 3.3, 3.4, 3.5, 3.6. To use Python version 2.7 change the first line of the example [Dockerfile](./example/Dockerfile) to:
+
+```
+FROM kilna/python-lambda:2.7
+```
+
+You will also need to change the following line in [config.yaml](./example/config.yaml)
+
+```
+runtime: python2.7
+```
+
+### Executing the Lambda Function
+
 If you want to execute the lambda function against the [event.json](./example/event.json) input file:
 
 ```
@@ -42,15 +62,17 @@ $ docker run example-lambda-image lambda invoke
                  |/
 ```
 
-If you would like to see if your lambda function build (which will package the lambda and all dependencies within the container into a zip file), run:
+### Building and Testing the Lambda Function
+
+If you would like to builf the lambda function (which will package the function and all its dependencies), run:
 
 ```
 $ docker run example-lambda-image lambda build
 ```
 
-### Build and Test
+The result will be a zip file created in the /lambda/dist directory inside the container.
 
-If you would like to build and test the lambda function and gather up the results, you can run:
+If you would like to build and _test_ the lambda function and gather up the results, you can run:
 
 ```
 $ docker run example-lambda-image lambda_build_tar | tar -x -v
@@ -60,26 +82,16 @@ dist/
 dist/2017-09-01-003647-example-lambda.zip
 ```
 
-Behind the scenes, what this script does is:
+Behind the scenes, what this does is:
 
 * Removes any log and dist files from prior runs
-* Runs 'lambda build' and stores the log in _/lambda/build.log_ in the container
-* If present and executable, run _/lambda/run_tests_ and stores the log in /lambda/test.log in the container
+* Executes 'lambda build' and stores the log in _/lambda/build.log_ in the container
+* If present and executable, runs _/lambda/run_tests_ and stores the log in /lambda/test.log in the container
 * Tars the log files, and the contents of the dist directory in /lambda on the container and pipes it to standard output
-* Untars the contents bundled up within the container, and extracts them into your current directory 
-
-### Python Version
-
-The example Dockerfile uses _:latest_ in the FROM line, which is currently the same as _:python-3.6_, but if you wish to use different python versions you can change this.
+* Untars the contents bundled up within the container, and extracts them into your current directory
 
-For instance, if you want to use Python version 2.7 change the first line of your Dockerfile from:
+### Deploying the Lambda Function
 
-```
-FROM kilna/python-lambda:latest
-```
+You can deploy your lambda function to Amazon's infrastructure...  firstly you'll want to add values to the 
 
-To:
 
-```
-FROM kilna/python-lambda:2.7
-```