Updating readme.md with some quick samples

README.md

@@ -2,4 +2,54 @@
 
 [![Build status](https://ci.appveyor.com/api/projects/status/9r6nb0nlbykw5fh7?svg=true)](https://ci.appveyor.com/project/TimHeuer/alexa-skills-dotnet)
 
-An Amazon Alexa Skills SDK for .NET
+Alexa.NET is a helper library for working with Alexa skill requests/responses in C#.  Whether you are using the AWS Lambda service or hosting your own service on your server, this library aims just to make working with the Alexa API more natural for a C# developer using a strongly-typed object model.
+
+# Some Quick Samples
+Here are some *simple* examples of how to use this library assuming the default signature of the AWS Lambda C# function:
+```csharp
+public SkillResponse FunctionHandler(SkillRequest input, ILambdaContext context)
+{
+    // your function logic goes here
+}
+```
+## Get the request type (Launch, Intent, etc)
+You most likely are going to want to get the type of request to know if it was the default launch, an intent, or maybe an audio request.
+```csharp
+// check what type of a request it is like an IntentRequest or a LaunchRequest
+var requestType = input.GetRequestType();
+
+if (requestType == typeof(IntentRequest))
+{
+    // do some intent-based stuff
+}
+else if (requestType == typeof(Alexa.NET.Request.Type.LaunchRequest))
+{
+    // default launch path executed
+}
+```
+
+## Get the intent and look at specifics
+Once you know it is an IntentRequest you probably want to know which one (name) and perhaps pull out parameters (slots):
+```csharp
+// do some intent-based stuff
+var intentRequest = input.Request as IntentRequest;
+
+// check the name to determine what you should do
+if (intentRequest.Intent.Name.Equals("MyIntentName"))
+{
+    // get the slots
+    var firstValue = intentRequest.Intent.Slots["FirstSlot"].Value;
+}
+```
+
+## Build the responses
+There are various types of responses you can build and this library provides a helper function to build them up.  A simple one of having Alexa tell the user something using SSML may look like this:
+```csharp
+// build the speech response firstValue
+var speech = new Alexa.NET.Response.SsmlOutputSpeech();
+speech.Ssml = "Today is <say-as interpret-as=\"date\">????0922</say-as>.<break strength=\"x-strong\"/>I hope you have a good day.";
+
+// create the response using the ResponseBuilder
+var finalResponse = ResponseBuilder.Tell(speech);
+return finalResponse;
+```