blog post links, and diagram added

Author: rabowskyb

README.md

@@ -1,12 +1,15 @@
-# lambda-java8-dynamodb
+## Serverless Architecture with Java 8, AWS Lambda, and Amazon DynamoDB 
 
 This code base is an example API built with the Java 8 runtime for AWS Lambda, in
-the context of a common use case:  an API backed by Amazon DynamoDB as its data store.
-By using Lambda together with DynamoDB, there is no need to deploy or manage servers
-for either the application tier or database tier.  If the front end consists of mobile
-devices and a web app statically hosted on Amazon S3, the result is a completely serverless
-architecture with no need to deploy or manage servers anywhere in the system, in either
-the front end or back end.
+the context of a common use case:  an API backed by Amazon DynamoDB as its data store.  In a production deployment, you would use Amazon API Gateway to proxy RESTful API requests to the Lambda functions, each of which corresponds to a single API call.  When API Gateway is added, the architecture is as follows:
+
+![Architecture](images/architecture.jpg)
+
+By using Lambda together with DynamoDB and API Gateway, there is no need to deploy or manage servers for either the application tier or database tier.  If the front end consists of mobile devices and a web app statically hosted on Amazon S3, the result is a completely serverless architecture with no need to deploy or manage servers anywhere in the system, in either the front end or back end.  For further information, see the following blog post series:
+- [Serverless Architectures with Java 8, AWS Lambda, and Amazon DynamoDB — Part 1](https://aws.amazon.com/blogs/startups/serverless-architectures-with-java-8-aws-lambda-and-amazon-dynamodb-part-1/).
+- [Serverless Architectures with Java 8, AWS Lambda, and Amazon DynamoDB — Part 2](https://aws.amazon.com/blogs/startups/serverless-architectures-with-java-8-aws-lambda-and-amazon-dynamodb-part-2/).
+
+### EXAMPLE USE CASE:
 
 The example use case is a company which maintains a catalog of sports events, and has decided
 to build an API for that catalog backed by DynamoDB.  For each event, the company needs to
@@ -35,9 +38,15 @@ as a partition or sort key for the table or a Global Secondary Index (GSI):
 	country:  String
 
 
-DEPLOYMENT NOTE:
+### DEPLOYMENT NOTE:
+
+Follow these steps to deploy the application:
+
+-  Create a DynamoDB table with the keys and attributes mentioned above.
+
+-  Create Lambda functions, one for each handler in the EventFunctions class.
+
+-  Create a API Gateway API.  Note that even if you don't do this step, you can still test the Lambda functions via the Lambda console "test function" tab.
 
-To deploy this API, consider using AWS SAM (Serverless Application Model).  Using SAM can simplify
-deploying an API, such as this one, built with a single code base that supports multiple Lambda 
-functions.  See http://docs.aws.amazon.com/lambda/latest/dg/deploying-lambda-apps.html.
+To automate deployment of the Lambda functions and API Gateway, consider using AWS SAM (Serverless Application Model).  Using SAM can simplify deploying an API, such as this one, built with a single code base that supports multiple Lambda functions.  See http://docs.aws.amazon.com/lambda/latest/dg/deploying-lambda-apps.html.