mdang · December 20, 2019 15:36 · May 15, 2017 · Jan 31, 2017 · Jan 31, 2017 · Jan 31, 2017
diff --git a/ALEXA.md b/ALEXA.md
@@ -9,7 +9,7 @@
 
 ## Why Develop for Alexa?
 
-- Millions of devices sold to date (Estimated 5 million)
+- Millions of devices sold to date (Estimated 11 million)
 - Top sellers on Amazon during Christmas 2016
 - Companies need developers to build out skills (e.g. Starbucks)
 

diff --git a/ALEXA.md b/ALEXA.md
@@ -101,6 +101,11 @@ Intents can optionally support named parameters with `slots`. Alexa will pass th
 }
 ```
 
+You can then access `slot` variables like so within Node: 
+```
+intent.slots.Sign.value
+```
+
 [Slot Type Reference](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/built-in-intent-ref/slot-type-reference)
 
 Create a set of sample utterances that map to your intents. These are the phrases users say when interacting with your skill.

diff --git a/ALEXA.md b/ALEXA.md
@@ -5,7 +5,7 @@
 - [AWS Account](https://aws.amazon.com/)
 - [Create a Developer Portal Account](https://developer.amazon.com/edw/home.html)
 - Alexa-enabled device for testing (Optional)
-  * http://alexa.amazon.com/
+  * Companion App - http://alexa.amazon.com/
 
 ## Why Develop for Alexa?
 

diff --git a/ALEXA.md b/ALEXA.md
@@ -5,6 +5,7 @@
 - [AWS Account](https://aws.amazon.com/)
 - [Create a Developer Portal Account](https://developer.amazon.com/edw/home.html)
 - Alexa-enabled device for testing (Optional)
+  * http://alexa.amazon.com/
 
 ## Why Develop for Alexa?
 

diff --git a/ALEXA.md b/ALEXA.md
@@ -114,6 +114,12 @@ HelloWorldIntent hi
 HelloWorldIntent how are you
 ```
 
+If you have slots defined, you can create a sample utterance like so:
+
+```
+GetHoroscopeIntent what will the horoscope for {Sign} be on {Date}
+```
+
 ### 2. Set up the Skill
 
 - [Registering and Managing Custom Skills in the Developer Portal](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/registering-and-managing-alexa-skills-in-the-developer-portal)

diff --git a/ALEXA.md b/ALEXA.md
@@ -75,7 +75,7 @@ Create your intent schema. This is a JSON structure which declares the set of re
 }
 ```
 
-Intents can optionally support named parameters with `slots`. Alexa will pass these values to the Lambda function when invoked
+Intents can optionally support named parameters with `slots`. Alexa will pass these values to the Lambda function when invoked.
 
 ```js
 {

diff --git a/ALEXA.md b/ALEXA.md
@@ -75,6 +75,33 @@ Create your intent schema. This is a JSON structure which declares the set of re
 }
 ```
 
+Intents can optionally support named parameters with `slots`. Alexa will pass these values to the Lambda function when invoked
+
+```js
+{
+  "intents": [
+    {
+      "intent": "GetHoroscope",
+      "slots": [
+        {
+          "name": "Sign",
+          "type": "LIST_OF_SIGNS"
+        },
+        {
+          "name": "Date",
+          "type": "AMAZON.DATE"
+        }
+      ]
+    },
+    {
+      "intent": "GetLuckyNumbers"
+    }
+  ]
+}
+```
+
+[Slot Type Reference](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/built-in-intent-ref/slot-type-reference)
+
 Create a set of sample utterances that map to your intents. These are the phrases users say when interacting with your skill.
 
 ```

diff --git a/ALEXA.md b/ALEXA.md
@@ -75,7 +75,7 @@ Create your intent schema. This is a JSON structure which declares the set of re
 }
 ```
 
-Develop the utterances or phrases that your skill will support 
+Create a set of sample utterances that map to your intents. These are the phrases users say when interacting with your skill.
 
 ```
 HelloWorldIntent say hello

diff --git a/ALEXA.md b/ALEXA.md
@@ -60,8 +60,7 @@ Every Alexa skill has an interaction model defining the words and phrases users
 - [Voice Design Best Practices](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/alexa-skills-kit-voice-design-best-practices)
 - [Understanding How Users Interact with Skills](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/understanding-how-users-interact-with-skills)
 
-Develop a JSON schema to be used 
-
+Create your intent schema. This is a JSON structure which declares the set of requests (“intents”) your service can accept and handle.
 ```js
 // IntentSchema.json
 {

diff --git a/ALEXA.md b/ALEXA.md
@@ -56,6 +56,7 @@ Every Alexa skill has an interaction model defining the words and phrases users
 
 ### 1. Design a Voice User Interface
 
+- [Defining the Voice User Interface](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/defining-the-voice-interface)
 - [Voice Design Best Practices](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/alexa-skills-kit-voice-design-best-practices)
 - [Understanding How Users Interact with Skills](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/understanding-how-users-interact-with-skills)
 

diff --git a/ALEXA.md b/ALEXA.md
@@ -27,7 +27,7 @@ Every Alexa skill has an interaction model defining the words and phrases users
 - [Smart Home Skill API](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/overviews/understanding-the-smart-home-skill-api) - The Smart Home Skill API enables you to create skills to control cloud-connected devices
 - [Flash Briefing Skill API](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/understanding-the-flash-briefing-skill-api) - A Flash Briefing Skill provides content for a customer’s Flash Briefing, and so when you create a Flash Briefing skill, you have a chance for your original content to reach customers on a daily basis.
 
-* [Understanding the Different Types of Skills](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/understanding-the-different-types-of-skills)
+[Understanding the Different Types of Skills](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/understanding-the-different-types-of-skills)
 
 ## Custom Skills
 

diff --git a/ALEXA.md b/ALEXA.md
@@ -27,7 +27,7 @@ Every Alexa skill has an interaction model defining the words and phrases users
 - [Smart Home Skill API](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/overviews/understanding-the-smart-home-skill-api) - The Smart Home Skill API enables you to create skills to control cloud-connected devices
 - [Flash Briefing Skill API](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/understanding-the-flash-briefing-skill-api) - A Flash Briefing Skill provides content for a customer’s Flash Briefing, and so when you create a Flash Briefing skill, you have a chance for your original content to reach customers on a daily basis.
 
-- [Understanding the Different Types of Skills](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/understanding-the-different-types-of-skills)
+* [Understanding the Different Types of Skills](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/understanding-the-different-types-of-skills)
 
 ## Custom Skills
 

diff --git a/ALEXA.md b/ALEXA.md
@@ -27,6 +27,8 @@ Every Alexa skill has an interaction model defining the words and phrases users
 - [Smart Home Skill API](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/overviews/understanding-the-smart-home-skill-api) - The Smart Home Skill API enables you to create skills to control cloud-connected devices
 - [Flash Briefing Skill API](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/understanding-the-flash-briefing-skill-api) - A Flash Briefing Skill provides content for a customer’s Flash Briefing, and so when you create a Flash Briefing skill, you have a chance for your original content to reach customers on a daily basis.
 
+- [Understanding the Different Types of Skills](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/understanding-the-different-types-of-skills)
+
 ## Custom Skills
 
 1. Define `intents` (Requests the skills can handle)
@@ -41,7 +43,6 @@ Every Alexa skill has an interaction model defining the words and phrases users
 
 > User: get high tide for Seattle from Tide Pooler
 
-- [Understanding the Different Types of Skills](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/understanding-the-different-types-of-skills)
 - [Understanding Custom Skills](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/overviews/understanding-custom-skills)
 
 ### Hosting Custom Skills

diff --git a/ALEXA.md b/ALEXA.md
@@ -8,7 +8,7 @@
 
 ## Why Develop for Alexa?
 
-- Millions of devices sold to date
+- Millions of devices sold to date (Estimated 5 million)
 - Top sellers on Amazon during Christmas 2016
 - Companies need developers to build out skills (e.g. Starbucks)
 

diff --git a/ALEXA.md b/ALEXA.md
@@ -58,6 +58,34 @@ Every Alexa skill has an interaction model defining the words and phrases users
 - [Voice Design Best Practices](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/alexa-skills-kit-voice-design-best-practices)
 - [Understanding How Users Interact with Skills](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/understanding-how-users-interact-with-skills)
 
+Develop a JSON schema to be used 
+
+```js
+// IntentSchema.json
+{
+  "intents": [
+    {
+      "intent": "HelloWorldIntent"
+    },
+    {
+      "intent": "AMAZON.HelpIntent"
+    }
+  ]
+}
+```
+
+Develop the utterances or phrases that your skill will support 
+
+```
+HelloWorldIntent say hello
+HelloWorldIntent say hello world
+HelloWorldIntent hello
+HelloWorldIntent say hi
+HelloWorldIntent say hi world
+HelloWorldIntent hi
+HelloWorldIntent how are you
+```
+
 ### 2. Set up the Skill
 
 - [Registering and Managing Custom Skills in the Developer Portal](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/registering-and-managing-alexa-skills-in-the-developer-portal)

diff --git a/ALEXA.md b/ALEXA.md
@@ -17,9 +17,9 @@
 When a user speaks to an Alexa-enabled device, the speech is streamed to the Alexa service in the cloud. Alexa recognizes the speech, determines what the user wants, and then sends a structured request to the particular skill that can fulfill the user’s request. All speech recognition and conversion is handled by Alexa in the cloud.
 Every Alexa skill has an interaction model defining the words and phrases users can say to make the skill do what they want. The type of skill you build dictates the interaction model that Alexa uses to communicate with your users.
 
-## Alexa Skills Kit
+## Alexa Skills
 
-- [Reference](https://developer.amazon.com/alexa-skills-kit)
+- [Alexa Skills Kit](https://developer.amazon.com/alexa-skills-kit)
 
 ### Skill Types 
 

diff --git a/ALEXA.md b/ALEXA.md
@@ -6,12 +6,18 @@
 - [Create a Developer Portal Account](https://developer.amazon.com/edw/home.html)
 - Alexa-enabled device for testing (Optional)
 
+## Why Develop for Alexa?
+
+- Millions of devices sold to date
+- Top sellers on Amazon during Christmas 2016
+- Companies need developers to build out skills (e.g. Starbucks)
+
 ## How Alexa Works
 
 When a user speaks to an Alexa-enabled device, the speech is streamed to the Alexa service in the cloud. Alexa recognizes the speech, determines what the user wants, and then sends a structured request to the particular skill that can fulfill the user’s request. All speech recognition and conversion is handled by Alexa in the cloud.
 Every Alexa skill has an interaction model defining the words and phrases users can say to make the skill do what they want. The type of skill you build dictates the interaction model that Alexa uses to communicate with your users.
 
-### Alexa Skills Kit
+## Alexa Skills Kit
 
 - [Reference](https://developer.amazon.com/alexa-skills-kit)
 

diff --git a/ALEXA.md b/ALEXA.md
@@ -45,7 +45,7 @@ Every Alexa skill has an interaction model defining the words and phrases users
 
 ## Create a Custom Skill
 
-- [Steps to Build a Custom Skill](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/overviews/steps-to-build-a-custom-skill)
+[Steps to Build a Custom Skill](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/overviews/steps-to-build-a-custom-skill)
 
 ### 1. Design a Voice User Interface
 

diff --git a/ALEXA.md b/ALEXA.md
@@ -65,7 +65,7 @@ Every Alexa skill has an interaction model defining the words and phrases users
 
 ### 4. Submit the Skill 
 
-[Submitting the Skill for Certification](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/publishing-an-alexa-skill)
+- [Submitting the Skill for Certification](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/publishing-an-alexa-skill)
 
 ## Code Samples
 

diff --git a/ALEXA.md b/ALEXA.md
@@ -63,6 +63,9 @@ Every Alexa skill has an interaction model defining the words and phrases users
 - [Fill in Lambda Function endpoints in the Developer Portal](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/registering-and-managing-alexa-skills-in-the-developer-portal)
 - [Test your skill with the Service Simulator or an Alexa-enabled device](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/testing-an-alexa-skill)
 
+### 4. Submit the Skill 
+
+[Submitting the Skill for Certification](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/publishing-an-alexa-skill)
 
 ## Code Samples
 

diff --git a/ALEXA.md b/ALEXA.md
@@ -49,8 +49,8 @@ Every Alexa skill has an interaction model defining the words and phrases users
 
 ### 1. Design a Voice User Interface
 
-a. [Voice Design Best Practices](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/alexa-skills-kit-voice-design-best-practices)
-b. [Understanding How Users Interact with Skills](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/understanding-how-users-interact-with-skills)
+- [Voice Design Best Practices](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/alexa-skills-kit-voice-design-best-practices)
+- [Understanding How Users Interact with Skills](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/understanding-how-users-interact-with-skills)
 
 ### 2. Set up the Skill
 

diff --git a/ALEXA.md b/ALEXA.md
@@ -49,8 +49,8 @@ Every Alexa skill has an interaction model defining the words and phrases users
 
 ### 1. Design a Voice User Interface
 
-- [Voice Design Best Practices](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/alexa-skills-kit-voice-design-best-practices)
-- [Understanding How Users Interact with Skills](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/understanding-how-users-interact-with-skills)
+a. [Voice Design Best Practices](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/alexa-skills-kit-voice-design-best-practices)
+b. [Understanding How Users Interact with Skills](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/understanding-how-users-interact-with-skills)
 
 ### 2. Set up the Skill
 

diff --git a/ALEXA.md b/ALEXA.md
@@ -61,7 +61,7 @@ Every Alexa skill has an interaction model defining the words and phrases users
 
 - [Creating an AWS Lambda Function for a Custom Skill](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/developing-an-alexa-skill-as-a-lambda-function)
 - [Fill in Lambda Function endpoints in the Developer Portal](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/registering-and-managing-alexa-skills-in-the-developer-portal)
-
+- [Test your skill with the Service Simulator or an Alexa-enabled device](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/testing-an-alexa-skill)
 
 
 ## Code Samples

diff --git a/ALEXA.md b/ALEXA.md
@@ -45,20 +45,24 @@ Every Alexa skill has an interaction model defining the words and phrases users
 
 ## Create a Custom Skill
 
-### Design a Voice User Interface
+- [Steps to Build a Custom Skill](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/overviews/steps-to-build-a-custom-skill)
 
-- [Voice Design Best Practices](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/alexa-skills-kit-voice-design-best-practices)
+### 1. Design a Voice User Interface
 
-### Intents
+- [Voice Design Best Practices](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/alexa-skills-kit-voice-design-best-practices)
+- [Understanding How Users Interact with Skills](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/understanding-how-users-interact-with-skills)
 
-### The Interaction Model
+### 2. Set up the Skill
 
-[Understanding How Users Interact with Skills](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/understanding-how-users-interact-with-skills)
+- [Registering and Managing Custom Skills in the Developer Portal](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/registering-and-managing-alexa-skills-in-the-developer-portal)
+- [Choose Invocation Name](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/choosing-the-invocation-name-for-an-alexa-skill)
 
-### Build Out Sample Phrases
+### 3. Write and Test the Code for Your Skill
 
 - [Creating an AWS Lambda Function for a Custom Skill](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/developing-an-alexa-skill-as-a-lambda-function)
-- [Steps to Build a Custom Skill](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/overviews/steps-to-build-a-custom-skill)
+- [Fill in Lambda Function endpoints in the Developer Portal](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/registering-and-managing-alexa-skills-in-the-developer-portal)
+
+
 
 ## Code Samples
 

diff --git a/ALEXA.md b/ALEXA.md
@@ -15,13 +15,13 @@ Every Alexa skill has an interaction model defining the words and phrases users
 
 - [Reference](https://developer.amazon.com/alexa-skills-kit)
 
-## Skill Types 
+### Skill Types 
 
 - [Custom Skills](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/overviews/understanding-custom-skills)
 - [Smart Home Skill API](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/overviews/understanding-the-smart-home-skill-api) - The Smart Home Skill API enables you to create skills to control cloud-connected devices
 - [Flash Briefing Skill API](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/understanding-the-flash-briefing-skill-api) - A Flash Briefing Skill provides content for a customer’s Flash Briefing, and so when you create a Flash Briefing skill, you have a chance for your original content to reach customers on a daily basis.
 
-### Custom Skills
+## Custom Skills
 
 1. Define `intents` (Requests the skills can handle)
   - **Look up tide information**
@@ -38,12 +38,12 @@ Every Alexa skill has an interaction model defining the words and phrases users
 - [Understanding the Different Types of Skills](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/understanding-the-different-types-of-skills)
 - [Understanding Custom Skills](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/overviews/understanding-custom-skills)
 
-#### Hosting Custom Skills
+### Hosting Custom Skills
 
 * [AWS Lambda](http://aws.amazon.com/lambda/)
 * [Custom Web Service](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/developing-an-alexa-skill-as-a-web-service)
 
-## Steps to Create a Custom Skill
+## Create a Custom Skill
 
 ### Design a Voice User Interface
 

diff --git a/ALEXA.md b/ALEXA.md
@@ -1,37 +1,21 @@
-## Alexa
+# Alexa
 
-### Learning Objectives
-
-## Prerequisites
+### Prerequisites
 
 - [AWS Account](https://aws.amazon.com/)
 - [Create a Developer Portal Account](https://developer.amazon.com/edw/home.html)
 - Alexa-enabled device for testing (Optional)
 
-## What is Alexa
-
-## How it Works
+## How Alexa Works
 
 When a user speaks to an Alexa-enabled device, the speech is streamed to the Alexa service in the cloud. Alexa recognizes the speech, determines what the user wants, and then sends a structured request to the particular skill that can fulfill the user’s request. All speech recognition and conversion is handled by Alexa in the cloud.
 Every Alexa skill has an interaction model defining the words and phrases users can say to make the skill do what they want. The type of skill you build dictates the interaction model that Alexa uses to communicate with your users.
 
-#### Alexa Skills Kit
+### Alexa Skills Kit
 
 - [Reference](https://developer.amazon.com/alexa-skills-kit)
 
-### Design a Voice User Interface
-
-- [Voice Design Best Practices](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/alexa-skills-kit-voice-design-best-practices)
-
-### Intents
-
-### The Interaction Model
-
-[Understanding How Users Interact with Skills](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/understanding-how-users-interact-with-skills)
-
-#### Build Out Sample Phrases
-
-### Skill Types 
+## Skill Types 
 
 - [Custom Skills](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/overviews/understanding-custom-skills)
 - [Smart Home Skill API](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/overviews/understanding-the-smart-home-skill-api) - The Smart Home Skill API enables you to create skills to control cloud-connected devices
@@ -61,6 +45,17 @@ Every Alexa skill has an interaction model defining the words and phrases users
 
 ## Steps to Create a Custom Skill
 
+### Design a Voice User Interface
+
+- [Voice Design Best Practices](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/alexa-skills-kit-voice-design-best-practices)
+
+### Intents
+
+### The Interaction Model
+
+[Understanding How Users Interact with Skills](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/understanding-how-users-interact-with-skills)
+
+### Build Out Sample Phrases
 
 - [Creating an AWS Lambda Function for a Custom Skill](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/developing-an-alexa-skill-as-a-lambda-function)
 - [Steps to Build a Custom Skill](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/overviews/steps-to-build-a-custom-skill)

diff --git a/ALEXA.md b/ALEXA.md
@@ -57,7 +57,7 @@ Every Alexa skill has an interaction model defining the words and phrases users
 #### Hosting Custom Skills
 
 * [AWS Lambda](http://aws.amazon.com/lambda/)
-* [Web Service](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/developing-an-alexa-skill-as-a-web-service)
+* [Custom Web Service](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/developing-an-alexa-skill-as-a-web-service)
 
 ## Steps to Create a Custom Skill
 

diff --git a/ALEXA.md b/ALEXA.md
@@ -67,4 +67,5 @@ Every Alexa skill has an interaction model defining the words and phrases users
 
 ## Code Samples
 
+- [Alexa Skills Kit SDK for Node.js](https://github.com/alexa/alexa-skills-kit-sdk-for-nodejs)
 - https://github.com/amzn/alexa-skills-kit-js/tree/master/samples/helloWorld
diff --git a/ALEXA.md b/ALEXA.md
@@ -21,7 +21,7 @@ Every Alexa skill has an interaction model defining the words and phrases users
 
 ### Design a Voice User Interface
 
-#### Voice Design Best Practices 
+- [Voice Design Best Practices](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/alexa-skills-kit-voice-design-best-practices)
 
 ### Intents
 

diff --git a/ALEXA.md b/ALEXA.md
@@ -6,7 +6,7 @@
 
 - [AWS Account](https://aws.amazon.com/)
 - [Create a Developer Portal Account](https://developer.amazon.com/edw/home.html)
-
+- Alexa-enabled device for testing (Optional)
 
 ## What is Alexa