diff --git a/Alexa.NET/project.json b/Alexa.NET/project.json
index f2ecfdc..a0f557f 100644
--- a/Alexa.NET/project.json
+++ b/Alexa.NET/project.json
@@ -27,6 +27,6 @@
"repository": { "url": "https://github.com/timheuer/alexa-skills-dotnet" },
"requireLicenseAcceptance": false,
"tags": [ "amazon", "alexa", "echo", "dot", "echo dot", "skills" ],
- "releaseNotes": "Updated to include Locale and Audio/PlayerController request support."
+ "releaseNotes": "Updated to include Locale, Audio request, and PlayerController request support."
}
}
diff --git a/README.md b/README.md
index 76cf089..54a91e3 100644
--- a/README.md
+++ b/README.md
@@ -66,3 +66,71 @@ var finalResponse = ResponseBuilder.TellWithCard(speech, "Your Card Title", "You
return finalResponse;
```
+
+## Build a simple response with a reprompt
+If you want to reprompt the user, use the Ask helpers
+```csharp
+// create the speech response
+var speech = new Alexa.NET.Response.SsmlOutputSpeech();
+speech.Ssml = "Today is ????0922.";
+
+// create the speech reprompt
+var repromptMessage = new Alexa.NET.Response.PlainTextOutputSpeech();
+repromptMessage.Text = "Would you like to know what tomorrow is?";
+
+// create the reprompt
+var repromptBody = new Alexa.NET.Response.Reprompt();
+repromptBody.OutputSpeech = repromptMessage;
+
+// create the response
+var finalResponse = ResponseBuilder.Ask(speech, repromptBody);
+return finalResponse;
+```
+
+## Build a response without using helpers
+If you do not want to use the helper Tell/Ask functions for the simple structure you
+can build up the response manually using the ```Response``` and some ```IOutputSpeech``` objects.
+```csharp
+// create the speech response - you most likely will still have this
+var speech = new Alexa.NET.Response.SsmlOutputSpeech();
+speech.Ssml = "Today is ????0922.";
+
+// create the response
+var responseBody = new Alexa.NET.Response.ResponseBody();
+responseBody.OutputSpeech = speech;
+responseBody.ShouldEndSession = true;
+
+var skillResponse = new Alexa.NET.Response.SkillResponse();
+skillResponse.Response = responseBody;
+skillResponse.Version = "1.0";
+
+return skillResponse;
+```
+
+## Build a reprompt without using helpers
+To add reprompt to the response you just need to include that as well.
+```csharp
+// create the speech response - you most likely will still have this
+var speech = new Alexa.NET.Response.SsmlOutputSpeech();
+speech.Ssml = "Today is ????0922.";
+
+// create the reprompt speech
+var repromptMessage = new Alexa.NET.Response.PlainTextOutputSpeech();
+repromptMessage.Text = "Would you like to know what tomorrow is?";
+
+// create the reprompt object
+var repromptBody = new Alexa.NET.Response.Reprompt();
+repromptBody.OutputSpeech = repromptMessage;
+
+// create the response
+var responseBody = new Alexa.NET.Response.ResponseBody();
+responseBody.OutputSpeech = speech;
+responseBody.ShouldEndSession = false; // this triggers the reprompt
+responseBody.Reprompt = repromptBody;
+
+var skillResponse = new Alexa.NET.Response.SkillResponse();
+skillResponse.Response = responseBody;
+skillResponse.Version = "1.0";
+
+return skillResponse;
+```
\ No newline at end of file