diff --git a/docs/Create-Your-First-Bot.md b/docs/archived docs/Create-Your-First-Bot.md similarity index 100% rename from docs/Create-Your-First-Bot.md rename to docs/archived docs/Create-Your-First-Bot.md diff --git a/docs/Deploying-Composer.md b/docs/archived docs/Deploying-Composer.md similarity index 100% rename from docs/Deploying-Composer.md rename to docs/archived docs/Deploying-Composer.md diff --git a/docs/bfcomposer-intro.md b/docs/archived docs/bfcomposer-intro.md similarity index 100% rename from docs/bfcomposer-intro.md rename to docs/archived docs/bfcomposer-intro.md diff --git a/docs/concept-dialog.md b/docs/archived docs/concept-dialog.md similarity index 100% rename from docs/concept-dialog.md rename to docs/archived docs/concept-dialog.md diff --git a/docs/concept-events-and-triggers.md b/docs/archived docs/concept-events-and-triggers.md similarity index 100% rename from docs/concept-events-and-triggers.md rename to docs/archived docs/concept-events-and-triggers.md diff --git a/docs/concept-language-generation.md b/docs/archived docs/concept-language-generation.md similarity index 100% rename from docs/concept-language-generation.md rename to docs/archived docs/concept-language-generation.md diff --git a/docs/concept-language-understanding.md b/docs/archived docs/concept-language-understanding.md similarity index 98% rename from docs/concept-language-understanding.md rename to docs/archived docs/concept-language-understanding.md index 1dd5df6757..3a6028676a 100644 --- a/docs/concept-language-understanding.md +++ b/docs/archived docs/concept-language-understanding.md @@ -1,156 +1,156 @@ -# Language Understanding - -Language Understanding (LU) is used by a bot to understand language naturally and contextually to determine what next to do in a conversation flow. In the Bot Framework Composer, the process is achieved through setting up recognizers and providing training data in the dialog so that the **intents** and **entities** contained in the message can be captured. These values will then be passed on to triggers which define how the bot responds using the appropriate actions. - -LU has the following characteristics when used in the Bot Framework Composer: - -- LU content can be authored in an inline editor or in **User Input** using the [.lu file format][100]. -- LU content is training data for recognizers. -- Composer currently supports LU technologies such as LUIS and Regular Expression. - -## Core LU concepts in Composer - -### Intents - -Intents are categories or classifications of user intentions. An intent represents an action the user wants to perform. The intent is a purpose or goal expressed in the user's input, such as booking a flight, paying a bill, or finding a news article. You define and name intents that correspond to these actions. A travel app may define an intent named "BookFlight." - -Here's a simple .lu file that captures a simple **Greeting** intent with a list of example utterances that capture different ways users will express this intent. You can use - or + or \* to denote lists. Numbered lists are not supported. - - # Greeting - - Hi - - Hello - - How are you? - -`#` describes a new intent definition section. Each line after the intent definition are example utterances that describe that intent. You can stitch together multiple intent definitions in a language understanding editor in Composer. Each section is identified by `#` notation. Blank lines are skipped when parsing the file. - -To define and use intents in Composer, you will need to: - -1. Setup **LUIS** as recognizer type. -2. Specify intent(s) and example utterances in [.lu file format](https://github.com/microsoft/botbuilder-tools/edit/master/packages/Ludown/docs/lu-file-format.md) as mentioned above. -3. Create an **Intent** trigger to handle each pre-defined intent. -4. Publish the training data to LUIS. - -> [!NOTE] -> For additional information on defining intents with the LUIS recognizer and Regular Expression recognizer refer to the [Defining triggers](how-to-define-triggers.md#intent) article. - -### Utterances - -Utterances are input from users and may have a lot of variations. Since utterances are not always well-formed, we need to provide example utterances for specific intents to train bots to recognize intents from different utterances. By doing so, your bots will have some "intelligence" to understand human languages. - -In Composer, utterances are always captured in a markdown list and followed by an intent. For example, the **Greeting** intent with some example utterances are shown in the [Intents](concept-language-understanding.md#intents) section above. - -You may have noticed that LU format is very similar to LG format but there are some key differences. - -- LU is for bots to understand user's input (primarily capture **intent** and more) -- LU is associated with recognizers (LUIS/Regular Expression) -- LG is for bots to respond to users as output -- LG is associated with a language generator - -### Entities - -Entities are a collection of objects, each consisting of data extracted from an utterance such as places, time, and people. Entities and intents are both important data extracted from utterances, but they are different. An intent indicates what the user is trying to do. An utterance may include zero or more entities, while an utterance usually represents one intent. In Composer, all entities are defined and managed inline. Entities in the [.lu file format][100] are denoted using {\=\} notation. For example: - - # BookFlight - - book a flight to {toCity=seattle} - - book a flight from {fromCity=new york} to {toCity=seattle} - -The example above shows the definition of a `BookFlight` intent with two example utterances and two entity definitions: `toCity` and `fromCity`. When triggered, if LUIS is able to identify a destination city, the city name will be made available as `@toCity` within the triggered actions or a departure city with `@fromCity` as available entity values. The entity values can be used directly in expressions and LG templates, or stored into a property in [memory](concept-memory.md) for later use. For additional information on entities see the article [advanced intents and entities](how-to-define-advanced-intents-entities.md). - -### Example - -The table below shows an example of an intent with its corresponding utterances and entities. All three utterances share the same intent _BookFlight_ each with a different entity. There are different types of entities, you can find more information in this article on the [LU file format][100]. - -| Intent | Utterances | Entity | -| ---------- | --------------------------------------------- | ----------------------- | -| BookFlight | "Book me a flight to London" | "London" | -| | "Fly me to London on the 31st" | "London", "31st" | -| | "I need a plane ticket next Sunday to London" | "next Sunday", "London" | - -Below is a similar definition of a _BookFlight_ intent with entity specification `{city=name}` and a set of example utterances. We use this example to show how they are manifested in Composer. Extracted entities are passed along to any triggered actions or child dialogs using the syntax `@city`. - -``` -# BookFlight -- book a flight to {city=austin} -- travel to {city=new york} -- I want to go to {city=los angeles} -``` - -After publishing, LUIS will be able to identify a city as entity and the city name will be made available as `@city` within the triggered actions. The entity value can be used directly in expressions and LG templates, or stored into a property in [memory](concept-memory.md) for later use. Read [here](how-to-define-advanced-intents-entities.md) for advanced intents and entities definition. - -## Author LU content in Composer - -To enable your bot to understand user's input contextually and conversationally so that your bot can decide how to respond to different user inputs, you should author LU as training data. - -To author proper LU content in Composer, you need to know: - -- [LU concepts](https://aka.ms/botbuilder-luis-concept?view=azure-bot-service-4.0) -- [.lu file format][100] -- [Common Expression Language](https://github.com/microsoft/BotBuilder-Samples/tree/master/experimental/common-expression-language#readme) - -To create the LU content, follow these steps: - -- Set up a **Recognizer** for a specific dialog (per dialog per recognizer). -- Author LU content as training data in [.lu format][100]. -- Create **Intent** triggers to wire up the LU content. -- Publish LU content (for LUIS). - -### Set up a recognizer - -Composer currently supports two types of recognizers: LUIS (by default) and Regular Expressions. This article focuses solely on the LUIS recognizer. Before setting up a recognizer type, you need to select the dialog you will be using for this purpose. In this example you will use the main dialog to set up LUIS as the recognizer type. - -1. Select the main dialog in the navigation pane. Then you will see the **Language Understanding** section in the bots properties panel on the right side of the Composer window. select **LUIS** from the **Recognizer Type** drop-down list. - ![select-recognizer](./media/language-understanding/select-recognizer.png) - -#### Author LU content - -After you set up the recognizer type, you can customize your LU content in the editor using the [.lu format][100]. - -For this example define two intents: **Greeting** and **CheckWeather** with some example utterances inline: - -![LU content](./media/language-understanding/LU-content.png) - -### Wire up LU content - -After you define the intents with example utterances, you need to create **Intent recognized** triggers in the dialog to handle each intent by defining the actions to take when an intent is recognized. - -1. Go to your bot's navigation pane on the left side and select **New Trigger**. - -2. In the `Create a trigger` pop-up window, select **Intent recognized** as the type of trigger. Pick the intent you want to handle from the drop-down menu and select **Submit**. - - ![Wireup intent](./media/language-understanding/wireup-intent.png) - -3. Click the **User Input** icon in Composer menu. You will see a list of all the LU content you have authored along with details such as which dialog the content is associated with and whether it is published or not. - - ![User Input](./media/language-understanding/user-input.png) - -### Publish LU - -Now the last step is to publish your LU content to LUIS. - -1. Select **Start Bot** on the upper right corner of the Composer. - -2. Fill in your **LUIS Authoring key** and select **OK**. - - > [!Note] - > If you do not have a LUIS account, you can get one on the [LUIS](https://www.luis.ai/home). If you have a LUIS account but do not know how to find your LUIS Authoring key please see the [Azure resources for LUIS](https://aka.ms/LUIS-Authoring-Keys#programmatic-key) section of the _Authoring and runtime keys_ article. - -3. Select **OK**. - ![Publish LU](./media/language-understanding/publish-lu.png) - -Any time you select **Start Bot** (or **Restart Bot**), Composer will evaluate if your LU content has changed. If so Composer will automatically make the required updates to your LUIS applications then train and publish them. If you go to your LUIS app website, you will find the newly published LU model. - -## References - -- [What is LUIS](https://aka.ms/luis-what-is-luis) -- [Language Understanding](https://aka.ms/botbuilder-luis-concept?view=azure-bot-service-4.0) -- [.lu file format][100] -- [Common Expression Language](https://github.com/microsoft/BotBuilder-Samples/tree/master/experimental/common-expression-language#readme) -- [Using LUIS for language understanding](https://github.com/microsoft/BotFramework-Composer/blob/kaiqb/Ignite2019/docs/howto-using-LUIS.md) -- [Extract data from utterance text with intents and entities](https://aka.ms/luis-concept-data-extraction?tabs=V2) - -## Next - -- Learn how to [use validation](./how-to-use-validation.md) -- Learn how to [send messages to users](how-to-send-messages.md) - -[100]:http://aka.ms/lu-file-format +# Language Understanding + +Language Understanding (LU) is used by a bot to understand language naturally and contextually to determine what next to do in a conversation flow. In the Bot Framework Composer, the process is achieved through setting up recognizers and providing training data in the dialog so that the **intents** and **entities** contained in the message can be captured. These values will then be passed on to triggers which define how the bot responds using the appropriate actions. + +LU has the following characteristics when used in the Bot Framework Composer: + +- LU content can be authored in an inline editor or in **User Input** using the [.lu file format][100]. +- LU content is training data for recognizers. +- Composer currently supports LU technologies such as LUIS and Regular Expression. + +## Core LU concepts in Composer + +### Intents + +Intents are categories or classifications of user intentions. An intent represents an action the user wants to perform. The intent is a purpose or goal expressed in the user's input, such as booking a flight, paying a bill, or finding a news article. You define and name intents that correspond to these actions. A travel app may define an intent named "BookFlight." + +Here's a simple .lu file that captures a simple **Greeting** intent with a list of example utterances that capture different ways users will express this intent. You can use - or + or \* to denote lists. Numbered lists are not supported. + + # Greeting + - Hi + - Hello + - How are you? + +`#` describes a new intent definition section. Each line after the intent definition are example utterances that describe that intent. You can stitch together multiple intent definitions in a language understanding editor in Composer. Each section is identified by `#` notation. Blank lines are skipped when parsing the file. + +To define and use intents in Composer, you will need to: + +1. Setup **LUIS** as recognizer type. +2. Specify intent(s) and example utterances in [.lu file format](https://github.com/microsoft/botbuilder-tools/edit/master/packages/Ludown/docs/lu-file-format.md) as mentioned above. +3. Create an **Intent** trigger to handle each pre-defined intent. +4. Publish the training data to LUIS. + +> [!NOTE] +> For additional information on defining intents with the LUIS recognizer and Regular Expression recognizer refer to the [Defining triggers](how-to-define-triggers.md#intent) article. + +### Utterances + +Utterances are input from users and may have a lot of variations. Since utterances are not always well-formed, we need to provide example utterances for specific intents to train bots to recognize intents from different utterances. By doing so, your bots will have some "intelligence" to understand human languages. + +In Composer, utterances are always captured in a markdown list and followed by an intent. For example, the **Greeting** intent with some example utterances are shown in the [Intents](concept-language-understanding.md#intents) section above. + +You may have noticed that LU format is very similar to LG format but there are some key differences. + +- LU is for bots to understand user's input (primarily capture **intent** and more) +- LU is associated with recognizers (LUIS/Regular Expression) +- LG is for bots to respond to users as output +- LG is associated with a language generator + +### Entities + +Entities are a collection of objects, each consisting of data extracted from an utterance such as places, time, and people. Entities and intents are both important data extracted from utterances, but they are different. An intent indicates what the user is trying to do. An utterance may include zero or more entities, while an utterance usually represents one intent. In Composer, all entities are defined and managed inline. Entities in the [.lu file format][100] are denoted using {\=\} notation. For example: + + # BookFlight + - book a flight to {toCity=seattle} + - book a flight from {fromCity=new york} to {toCity=seattle} + +The example above shows the definition of a `BookFlight` intent with two example utterances and two entity definitions: `toCity` and `fromCity`. When triggered, if LUIS is able to identify a destination city, the city name will be made available as `@toCity` within the triggered actions or a departure city with `@fromCity` as available entity values. The entity values can be used directly in expressions and LG templates, or stored into a property in [memory](concept-memory.md) for later use. For additional information on entities see the article [advanced intents and entities](how-to-define-advanced-intents-entities.md). + +### Example + +The table below shows an example of an intent with its corresponding utterances and entities. All three utterances share the same intent _BookFlight_ each with a different entity. There are different types of entities, you can find more information in this article on the [LU file format][100]. + +| Intent | Utterances | Entity | +| ---------- | --------------------------------------------- | ----------------------- | +| BookFlight | "Book me a flight to London" | "London" | +| | "Fly me to London on the 31st" | "London", "31st" | +| | "I need a plane ticket next Sunday to London" | "next Sunday", "London" | + +Below is a similar definition of a _BookFlight_ intent with entity specification `{city=name}` and a set of example utterances. We use this example to show how they are manifested in Composer. Extracted entities are passed along to any triggered actions or child dialogs using the syntax `@city`. + +``` +# BookFlight +- book a flight to {city=austin} +- travel to {city=new york} +- I want to go to {city=los angeles} +``` + +After publishing, LUIS will be able to identify a city as entity and the city name will be made available as `@city` within the triggered actions. The entity value can be used directly in expressions and LG templates, or stored into a property in [memory](concept-memory.md) for later use. Read [here](how-to-define-advanced-intents-entities.md) for advanced intents and entities definition. + +## Author LU content in Composer + +To enable your bot to understand user's input contextually and conversationally so that your bot can decide how to respond to different user inputs, you should author LU as training data. + +To author proper LU content in Composer, you need to know: + +- [LU concepts](https://aka.ms/botbuilder-luis-concept?view=azure-bot-service-4.0) +- [.lu file format][100] +- [Common Expression Language](https://github.com/microsoft/BotBuilder-Samples/tree/master/experimental/common-expression-language#readme) + +To create the LU content, follow these steps: + +- Set up a **Recognizer** for a specific dialog (per dialog per recognizer). +- Author LU content as training data in [.lu format][100]. +- Create **Intent** triggers to wire up the LU content. +- Publish LU content (for LUIS). + +### Set up a recognizer + +Composer currently supports two types of recognizers: LUIS (by default) and Regular Expressions. This article focuses solely on the LUIS recognizer. Before setting up a recognizer type, you need to select the dialog you will be using for this purpose. In this example you will use the main dialog to set up LUIS as the recognizer type. + +1. Select the main dialog in the navigation pane. Then you will see the **Language Understanding** section in the bots properties panel on the right side of the Composer window. select **LUIS** from the **Recognizer Type** drop-down list. + ![select-recognizer](./media/language-understanding/select-recognizer.png) + +#### Author LU content + +After you set up the recognizer type, you can customize your LU content in the editor using the [.lu format][100]. + +For this example define two intents: **Greeting** and **CheckWeather** with some example utterances inline: + +![LU content](./media/language-understanding/LU-content.png) + +### Wire up LU content + +After you define the intents with example utterances, you need to create **Intent recognized** triggers in the dialog to handle each intent by defining the actions to take when an intent is recognized. + +1. Go to your bot's navigation pane on the left side and select **New Trigger**. + +2. In the `Create a trigger` pop-up window, select **Intent recognized** as the type of trigger. Pick the intent you want to handle from the drop-down menu and select **Submit**. + + ![Wireup intent](./media/language-understanding/wireup-intent.png) + +3. Click the **User Input** icon in Composer menu. You will see a list of all the LU content you have authored along with details such as which dialog the content is associated with and whether it is published or not. + + ![User Input](./media/language-understanding/user-input.png) + +### Publish LU + +Now the last step is to publish your LU content to LUIS. + +1. Select **Start Bot** on the upper right corner of the Composer. + +2. Fill in your **LUIS Authoring key** and select **OK**. + + > [!Note] + > If you do not have a LUIS account, you can get one on the [LUIS](https://www.luis.ai/home). If you have a LUIS account but do not know how to find your LUIS Authoring key please see the [Azure resources for LUIS](https://aka.ms/LUIS-Authoring-Keys#programmatic-key) section of the _Authoring and runtime keys_ article. + +3. Select **OK**. + ![Publish LU](./media/language-understanding/publish-lu.png) + +Any time you select **Start Bot** (or **Restart Bot**), Composer will evaluate if your LU content has changed. If so Composer will automatically make the required updates to your LUIS applications then train and publish them. If you go to your LUIS app website, you will find the newly published LU model. + +## References + +- [What is LUIS](https://aka.ms/luis-what-is-luis) +- [Language Understanding](https://aka.ms/botbuilder-luis-concept?view=azure-bot-service-4.0) +- [.lu file format][100] +- [Common Expression Language](https://github.com/microsoft/BotBuilder-Samples/tree/master/experimental/common-expression-language#readme) +- [Using LUIS for language understanding](https://github.com/microsoft/BotFramework-Composer/blob/kaiqb/Ignite2019/docs/howto-using-LUIS.md) +- [Extract data from utterance text with intents and entities](https://aka.ms/luis-concept-data-extraction?tabs=V2) + +## Next + +- Learn how to [use validation](./how-to-use-validation.md) +- Learn how to [send messages to users](how-to-send-messages.md) + +[100]:http://aka.ms/lu-file-format diff --git a/docs/concept-memory.md b/docs/archived docs/concept-memory.md similarity index 100% rename from docs/concept-memory.md rename to docs/archived docs/concept-memory.md diff --git a/docs/how-to-add-qna-to-bot.md b/docs/archived docs/how-to-add-qna-to-bot.md similarity index 100% rename from docs/how-to-add-qna-to-bot.md rename to docs/archived docs/how-to-add-qna-to-bot.md diff --git a/docs/how-to-ask-for-user-input.md b/docs/archived docs/how-to-ask-for-user-input.md similarity index 100% rename from docs/how-to-ask-for-user-input.md rename to docs/archived docs/how-to-ask-for-user-input.md diff --git a/docs/how-to-connect-to-remote-skill.md b/docs/archived docs/how-to-connect-to-remote-skill.md similarity index 100% rename from docs/how-to-connect-to-remote-skill.md rename to docs/archived docs/how-to-connect-to-remote-skill.md diff --git a/docs/how-to-control-conversation-flow.md b/docs/archived docs/how-to-control-conversation-flow.md similarity index 100% rename from docs/how-to-control-conversation-flow.md rename to docs/archived docs/how-to-control-conversation-flow.md diff --git a/docs/how-to-define-advanced-intents-entities.md b/docs/archived docs/how-to-define-advanced-intents-entities.md similarity index 100% rename from docs/how-to-define-advanced-intents-entities.md rename to docs/archived docs/how-to-define-advanced-intents-entities.md diff --git a/docs/how-to-define-triggers.md b/docs/archived docs/how-to-define-triggers.md similarity index 100% rename from docs/how-to-define-triggers.md rename to docs/archived docs/how-to-define-triggers.md diff --git a/docs/how-to-publish-bot.md b/docs/archived docs/how-to-publish-bot.md similarity index 100% rename from docs/how-to-publish-bot.md rename to docs/archived docs/how-to-publish-bot.md diff --git a/docs/how-to-send-cards.md b/docs/archived docs/how-to-send-cards.md similarity index 100% rename from docs/how-to-send-cards.md rename to docs/archived docs/how-to-send-cards.md diff --git a/docs/how-to-send-http-request.md b/docs/archived docs/how-to-send-http-request.md similarity index 100% rename from docs/how-to-send-http-request.md rename to docs/archived docs/how-to-send-http-request.md diff --git a/docs/how-to-send-messages.md b/docs/archived docs/how-to-send-messages.md similarity index 100% rename from docs/how-to-send-messages.md rename to docs/archived docs/how-to-send-messages.md diff --git a/docs/how-to-use-LUIS.md b/docs/archived docs/how-to-use-LUIS.md similarity index 100% rename from docs/how-to-use-LUIS.md rename to docs/archived docs/how-to-use-LUIS.md diff --git a/docs/how-to-use-oauth.md b/docs/archived docs/how-to-use-oauth.md similarity index 100% rename from docs/how-to-use-oauth.md rename to docs/archived docs/how-to-use-oauth.md diff --git a/docs/how-to-use-validation.md b/docs/archived docs/how-to-use-validation.md similarity index 98% rename from docs/how-to-use-validation.md rename to docs/archived docs/how-to-use-validation.md index 2cb38d4e51..ae05e3df9b 100644 --- a/docs/how-to-use-validation.md +++ b/docs/archived docs/how-to-use-validation.md @@ -1,58 +1,58 @@ -# Linting and validation - -As an integrated development tool, Bot Framework Composer supports validation of data when you author an [.lg](https://aka.ms/lg-file-format) template, an [.lu](https://aka.ms/lu-file-format) template, and [expressions](https://github.com/microsoft/BotBuilder-Samples/tree/master/experimental/common-expression-language) to fill in property fields. Error indicators will show in both inline editors and corresponding all-up views (**Bot Responses** and **User Input**). The **Notifications** page (click **Notifications** icon on the left navigation pane) displays an aggregation of all errors and warnings. With the help of linting and validation, your bot-authoring experience will be improved and you can easily build a functional bot that can "run". - -> [!NOTE] -> We are still working to improve the implementation of linting and validation in Composer. More user scenarios will be updated. - -Whenever you see `Start Bot` button in grey, this indicates your bot has errors that prevent it from running successfully. - -![start-grey](./media/validation/start-grey.png) - -The number beside the error icon indicates the number of errors. Click the error icon you will be navigated to the **Notifications** page listing all errors and warnings. - -![notification-all-up-view](./media/validation/notification-all-up-view.png) - -Click any of the errors on the **Notifications** page will navigate you to the matching error location. After you fix all the errors, you will see the `Start Bot` button in blue, this indicates your bot has no errors and it will run successfully. - -## .lg files - -When you author an [.lg template](https://aka.ms/lg-file-format) that has syntax errors, an indicator will show in the inline editor with a red wiggling line. - -![inline-error-lg](./media/validation/inline-error-lg.png) - -To diagnose and fix the error, you can read the error message beneath the editor and click `here` to refer to the syntax documentation. You can also hover your mouse over the erroneous part and read the detailed error message with suggested fixes. - -![hover-message-lg](./media/validation/hover-message-lg.png) - -Click **Bot Responses** on the left navigation pane, you will find the error is also saved and updated in the lg all-up view. The tiny red rectangle on the right end of the editor helps you to identify where the error is. This is especially helpful when you have a long list of templates. Hover your mouse over the erroneous part you will see detailed error message with suggested fixes. - -![lg-all-up-view](./media/validation/lg-all-up-view.png) - -## .lu files - -When you author an [.lu template](https://aka.ms/lu-file-format) that has syntax errors, the entire lu inline editor will be in red frame. To diagnose and fix the error, you can read the error message beneath the editor and click `here` to refer to the syntax documentation. - -![lu-inline-error](./media/validation/lu-inline-error.png) - -Click **User Input** on the left navigation pane, you will see a popup window describing the lu error message. - -![lu-popup](./media/validation/lu-popup.png) - -Click **Edit** button you will see the error is also saved and updated in the lu all-up view. You can choose to fix the error either in the lu all-up view or in the inline editor. - -![lu-all-up-view](./media/validation/lu-all-up-view.png) - -## Expressions - -When you fill in property fields with invalid [expressions](https://github.com/microsoft/BotBuilder-Samples/tree/master/experimental/common-expression-language) or when a required property is missing, the entire form editor will be in red frame. - -![expression-inline-error](./media/validation/expression-inline-error.png) - -To diagnose and fix the error, you can read the error message beneath the editor and click `here` to refer to the syntax documentation. - -![expression-missing-property](./media/validation/expression-missing-property.png) - -# Next - -TBD +# Linting and validation + +As an integrated development tool, Bot Framework Composer supports validation of data when you author an [.lg](https://aka.ms/lg-file-format) template, an [.lu](https://aka.ms/lu-file-format) template, and [expressions](https://github.com/microsoft/BotBuilder-Samples/tree/master/experimental/common-expression-language) to fill in property fields. Error indicators will show in both inline editors and corresponding all-up views (**Bot Responses** and **User Input**). The **Notifications** page (click **Notifications** icon on the left navigation pane) displays an aggregation of all errors and warnings. With the help of linting and validation, your bot-authoring experience will be improved and you can easily build a functional bot that can "run". + +> [!NOTE] +> We are still working to improve the implementation of linting and validation in Composer. More user scenarios will be updated. + +Whenever you see `Start Bot` button in grey, this indicates your bot has errors that prevent it from running successfully. + +![start-grey](./media/validation/start-grey.png) + +The number beside the error icon indicates the number of errors. Click the error icon you will be navigated to the **Notifications** page listing all errors and warnings. + +![notification-all-up-view](./media/validation/notification-all-up-view.png) + +Click any of the errors on the **Notifications** page will navigate you to the matching error location. After you fix all the errors, you will see the `Start Bot` button in blue, this indicates your bot has no errors and it will run successfully. + +## .lg files + +When you author an [.lg template](https://aka.ms/lg-file-format) that has syntax errors, an indicator will show in the inline editor with a red wiggling line. + +![inline-error-lg](./media/validation/inline-error-lg.png) + +To diagnose and fix the error, you can read the error message beneath the editor and click `here` to refer to the syntax documentation. You can also hover your mouse over the erroneous part and read the detailed error message with suggested fixes. + +![hover-message-lg](./media/validation/hover-message-lg.png) + +Click **Bot Responses** on the left navigation pane, you will find the error is also saved and updated in the lg all-up view. The tiny red rectangle on the right end of the editor helps you to identify where the error is. This is especially helpful when you have a long list of templates. Hover your mouse over the erroneous part you will see detailed error message with suggested fixes. + +![lg-all-up-view](./media/validation/lg-all-up-view.png) + +## .lu files + +When you author an [.lu template](https://aka.ms/lu-file-format) that has syntax errors, the entire lu inline editor will be in red frame. To diagnose and fix the error, you can read the error message beneath the editor and click `here` to refer to the syntax documentation. + +![lu-inline-error](./media/validation/lu-inline-error.png) + +Click **User Input** on the left navigation pane, you will see a popup window describing the lu error message. + +![lu-popup](./media/validation/lu-popup.png) + +Click **Edit** button you will see the error is also saved and updated in the lu all-up view. You can choose to fix the error either in the lu all-up view or in the inline editor. + +![lu-all-up-view](./media/validation/lu-all-up-view.png) + +## Expressions + +When you fill in property fields with invalid [expressions](https://github.com/microsoft/BotBuilder-Samples/tree/master/experimental/common-expression-language) or when a required property is missing, the entire form editor will be in red frame. + +![expression-inline-error](./media/validation/expression-inline-error.png) + +To diagnose and fix the error, you can read the error message beneath the editor and click `here` to refer to the syntax documentation. + +![expression-missing-property](./media/validation/expression-missing-property.png) + +# Next + +TBD diff --git a/docs/introduction.md b/docs/archived docs/introduction.md similarity index 100% rename from docs/introduction.md rename to docs/archived docs/introduction.md diff --git a/docs/media/add_luis/author_lu.png b/docs/archived docs/media/add_luis/author_lu.png similarity index 100% rename from docs/media/add_luis/author_lu.png rename to docs/archived docs/media/add_luis/author_lu.png diff --git a/docs/media/add_luis/configure_intent.png b/docs/archived docs/media/add_luis/configure_intent.png similarity index 100% rename from docs/media/add_luis/configure_intent.png rename to docs/archived docs/media/add_luis/configure_intent.png diff --git a/docs/media/add_luis/create_trigger.png b/docs/archived docs/media/add_luis/create_trigger.png similarity index 100% rename from docs/media/add_luis/create_trigger.png rename to docs/archived docs/media/add_luis/create_trigger.png diff --git a/docs/media/add_luis/emulator.gif b/docs/archived docs/media/add_luis/emulator.gif similarity index 100% rename from docs/media/add_luis/emulator.gif rename to docs/archived docs/media/add_luis/emulator.gif diff --git a/docs/media/add_luis/greeting_message.png b/docs/archived docs/media/add_luis/greeting_message.png similarity index 100% rename from docs/media/add_luis/greeting_message.png rename to docs/archived docs/media/add_luis/greeting_message.png diff --git a/docs/media/add_luis/publish_luis.png b/docs/archived docs/media/add_luis/publish_luis.png similarity index 100% rename from docs/media/add_luis/publish_luis.png rename to docs/archived docs/media/add_luis/publish_luis.png diff --git a/docs/media/add_luis/response_message.png b/docs/archived docs/media/add_luis/response_message.png similarity index 100% rename from docs/media/add_luis/response_message.png rename to docs/archived docs/media/add_luis/response_message.png diff --git a/docs/media/add_luis/send_response_message.png b/docs/archived docs/media/add_luis/send_response_message.png similarity index 100% rename from docs/media/add_luis/send_response_message.png rename to docs/archived docs/media/add_luis/send_response_message.png diff --git a/docs/media/add_luis/show_intent_in_trigger.png b/docs/archived docs/media/add_luis/show_intent_in_trigger.png similarity index 100% rename from docs/media/add_luis/show_intent_in_trigger.png rename to docs/archived docs/media/add_luis/show_intent_in_trigger.png diff --git a/docs/media/ask-for-input/choice-and-inline.png b/docs/archived docs/media/ask-for-input/choice-and-inline.png similarity index 100% rename from docs/media/ask-for-input/choice-and-inline.png rename to docs/archived docs/media/ask-for-input/choice-and-inline.png diff --git a/docs/media/ask-for-input/multichoice-list-auto.png b/docs/archived docs/media/ask-for-input/multichoice-list-auto.png similarity index 100% rename from docs/media/ask-for-input/multichoice-list-auto.png rename to docs/archived docs/media/ask-for-input/multichoice-list-auto.png diff --git a/docs/media/ask-for-input/multichoice-list-herocard.png b/docs/archived docs/media/ask-for-input/multichoice-list-herocard.png similarity index 100% rename from docs/media/ask-for-input/multichoice-list-herocard.png rename to docs/archived docs/media/ask-for-input/multichoice-list-herocard.png diff --git a/docs/media/ask-for-input/multichoice-list-inline.png b/docs/archived docs/media/ask-for-input/multichoice-list-inline.png similarity index 100% rename from docs/media/ask-for-input/multichoice-list-inline.png rename to docs/archived docs/media/ask-for-input/multichoice-list-inline.png diff --git a/docs/media/ask-for-input/multichoice-list-list.png b/docs/archived docs/media/ask-for-input/multichoice-list-list.png similarity index 100% rename from docs/media/ask-for-input/multichoice-list-list.png rename to docs/archived docs/media/ask-for-input/multichoice-list-list.png diff --git a/docs/media/ask-for-input/multichoice-list-none.png b/docs/archived docs/media/ask-for-input/multichoice-list-none.png similarity index 100% rename from docs/media/ask-for-input/multichoice-list-none.png rename to docs/archived docs/media/ask-for-input/multichoice-list-none.png diff --git a/docs/media/ask-for-input/multichoice-list-suggestedactions.png b/docs/archived docs/media/ask-for-input/multichoice-list-suggestedactions.png similarity index 100% rename from docs/media/ask-for-input/multichoice-list-suggestedactions.png rename to docs/archived docs/media/ask-for-input/multichoice-list-suggestedactions.png diff --git a/docs/media/ask-for-input/number-dialog.png b/docs/archived docs/media/ask-for-input/number-dialog.png similarity index 100% rename from docs/media/ask-for-input/number-dialog.png rename to docs/archived docs/media/ask-for-input/number-dialog.png diff --git a/docs/media/ask-for-input/other.png b/docs/archived docs/media/ask-for-input/other.png similarity index 100% rename from docs/media/ask-for-input/other.png rename to docs/archived docs/media/ask-for-input/other.png diff --git a/docs/media/ask-for-input/select-attachment-prompt.png b/docs/archived docs/media/ask-for-input/select-attachment-prompt.png similarity index 100% rename from docs/media/ask-for-input/select-attachment-prompt.png rename to docs/archived docs/media/ask-for-input/select-attachment-prompt.png diff --git a/docs/media/ask-for-input/select-confirmation-prompt.png b/docs/archived docs/media/ask-for-input/select-confirmation-prompt.png similarity index 100% rename from docs/media/ask-for-input/select-confirmation-prompt.png rename to docs/archived docs/media/ask-for-input/select-confirmation-prompt.png diff --git a/docs/media/ask-for-input/select-datetime-prompt.png b/docs/archived docs/media/ask-for-input/select-datetime-prompt.png similarity index 100% rename from docs/media/ask-for-input/select-datetime-prompt.png rename to docs/archived docs/media/ask-for-input/select-datetime-prompt.png diff --git a/docs/media/ask-for-input/select-multiple-choice-prompt.png b/docs/archived docs/media/ask-for-input/select-multiple-choice-prompt.png similarity index 100% rename from docs/media/ask-for-input/select-multiple-choice-prompt.png rename to docs/archived docs/media/ask-for-input/select-multiple-choice-prompt.png diff --git a/docs/media/ask-for-input/select-number-prompt.png b/docs/archived docs/media/ask-for-input/select-number-prompt.png similarity index 100% rename from docs/media/ask-for-input/select-number-prompt.png rename to docs/archived docs/media/ask-for-input/select-number-prompt.png diff --git a/docs/media/ask-for-input/select-text-prompt.png b/docs/archived docs/media/ask-for-input/select-text-prompt.png similarity index 100% rename from docs/media/ask-for-input/select-text-prompt.png rename to docs/archived docs/media/ask-for-input/select-text-prompt.png diff --git a/docs/media/ask-for-input/settings.png b/docs/archived docs/media/ask-for-input/settings.png similarity index 100% rename from docs/media/ask-for-input/settings.png rename to docs/archived docs/media/ask-for-input/settings.png diff --git a/docs/media/ask-for-input/text-bot-asks.png b/docs/archived docs/media/ask-for-input/text-bot-asks.png similarity index 100% rename from docs/media/ask-for-input/text-bot-asks.png rename to docs/archived docs/media/ask-for-input/text-bot-asks.png diff --git a/docs/media/ask-for-input/text-user-input.png b/docs/archived docs/media/ask-for-input/text-user-input.png similarity index 100% rename from docs/media/ask-for-input/text-user-input.png rename to docs/archived docs/media/ask-for-input/text-user-input.png diff --git a/docs/media/controlling-conversation-flow/begin-a-new-dialog-options.png b/docs/archived docs/media/controlling-conversation-flow/begin-a-new-dialog-options.png similarity index 100% rename from docs/media/controlling-conversation-flow/begin-a-new-dialog-options.png rename to docs/archived docs/media/controlling-conversation-flow/begin-a-new-dialog-options.png diff --git a/docs/media/controlling-conversation-flow/create-condition-menu.png b/docs/archived docs/media/controlling-conversation-flow/create-condition-menu.png similarity index 100% rename from docs/media/controlling-conversation-flow/create-condition-menu.png rename to docs/archived docs/media/controlling-conversation-flow/create-condition-menu.png diff --git a/docs/media/controlling-conversation-flow/dialog-management-menu.png b/docs/archived docs/media/controlling-conversation-flow/dialog-management-menu.png similarity index 100% rename from docs/media/controlling-conversation-flow/dialog-management-menu.png rename to docs/archived docs/media/controlling-conversation-flow/dialog-management-menu.png diff --git a/docs/media/controlling-conversation-flow/end-this-dialog.png b/docs/archived docs/media/controlling-conversation-flow/end-this-dialog.png similarity index 100% rename from docs/media/controlling-conversation-flow/end-this-dialog.png rename to docs/archived docs/media/controlling-conversation-flow/end-this-dialog.png diff --git a/docs/media/controlling-conversation-flow/for-each-items-property.png b/docs/archived docs/media/controlling-conversation-flow/for-each-items-property.png similarity index 100% rename from docs/media/controlling-conversation-flow/for-each-items-property.png rename to docs/archived docs/media/controlling-conversation-flow/for-each-items-property.png diff --git a/docs/media/controlling-conversation-flow/for-each-page-property.png b/docs/archived docs/media/controlling-conversation-flow/for-each-page-property.png similarity index 100% rename from docs/media/controlling-conversation-flow/for-each-page-property.png rename to docs/archived docs/media/controlling-conversation-flow/for-each-page-property.png diff --git a/docs/media/controlling-conversation-flow/for-each-send-response.png b/docs/archived docs/media/controlling-conversation-flow/for-each-send-response.png similarity index 100% rename from docs/media/controlling-conversation-flow/for-each-send-response.png rename to docs/archived docs/media/controlling-conversation-flow/for-each-send-response.png diff --git a/docs/media/controlling-conversation-flow/if-else-condition.png b/docs/archived docs/media/controlling-conversation-flow/if-else-condition.png similarity index 100% rename from docs/media/controlling-conversation-flow/if-else-condition.png rename to docs/archived docs/media/controlling-conversation-flow/if-else-condition.png diff --git a/docs/media/controlling-conversation-flow/if-else-send-response.png b/docs/archived docs/media/controlling-conversation-flow/if-else-send-response.png similarity index 100% rename from docs/media/controlling-conversation-flow/if-else-send-response.png rename to docs/archived docs/media/controlling-conversation-flow/if-else-send-response.png diff --git a/docs/media/controlling-conversation-flow/nested-for-each.png b/docs/archived docs/media/controlling-conversation-flow/nested-for-each.png similarity index 100% rename from docs/media/controlling-conversation-flow/nested-for-each.png rename to docs/archived docs/media/controlling-conversation-flow/nested-for-each.png diff --git a/docs/media/controlling-conversation-flow/select-begin-a-new-dialog.png b/docs/archived docs/media/controlling-conversation-flow/select-begin-a-new-dialog.png similarity index 100% rename from docs/media/controlling-conversation-flow/select-begin-a-new-dialog.png rename to docs/archived docs/media/controlling-conversation-flow/select-begin-a-new-dialog.png diff --git a/docs/media/controlling-conversation-flow/select-end-this-dialog.png b/docs/archived docs/media/controlling-conversation-flow/select-end-this-dialog.png similarity index 100% rename from docs/media/controlling-conversation-flow/select-end-this-dialog.png rename to docs/archived docs/media/controlling-conversation-flow/select-end-this-dialog.png diff --git a/docs/media/controlling-conversation-flow/select-for-each-page.png b/docs/archived docs/media/controlling-conversation-flow/select-for-each-page.png similarity index 100% rename from docs/media/controlling-conversation-flow/select-for-each-page.png rename to docs/archived docs/media/controlling-conversation-flow/select-for-each-page.png diff --git a/docs/media/controlling-conversation-flow/select-for-each.png b/docs/archived docs/media/controlling-conversation-flow/select-for-each.png similarity index 100% rename from docs/media/controlling-conversation-flow/select-for-each.png rename to docs/archived docs/media/controlling-conversation-flow/select-for-each.png diff --git a/docs/media/controlling-conversation-flow/select-if-else.png b/docs/archived docs/media/controlling-conversation-flow/select-if-else.png similarity index 100% rename from docs/media/controlling-conversation-flow/select-if-else.png rename to docs/archived docs/media/controlling-conversation-flow/select-if-else.png diff --git a/docs/media/controlling-conversation-flow/select-repeat-this-dialog.png b/docs/archived docs/media/controlling-conversation-flow/select-repeat-this-dialog.png similarity index 100% rename from docs/media/controlling-conversation-flow/select-repeat-this-dialog.png rename to docs/archived docs/media/controlling-conversation-flow/select-repeat-this-dialog.png diff --git a/docs/media/controlling-conversation-flow/select-replace-this-dialog.png b/docs/archived docs/media/controlling-conversation-flow/select-replace-this-dialog.png similarity index 100% rename from docs/media/controlling-conversation-flow/select-replace-this-dialog.png rename to docs/archived docs/media/controlling-conversation-flow/select-replace-this-dialog.png diff --git a/docs/media/controlling-conversation-flow/select-switch.png b/docs/archived docs/media/controlling-conversation-flow/select-switch.png similarity index 100% rename from docs/media/controlling-conversation-flow/select-switch.png rename to docs/archived docs/media/controlling-conversation-flow/select-switch.png diff --git a/docs/media/controlling-conversation-flow/switch-add-branches.gif b/docs/archived docs/media/controlling-conversation-flow/switch-add-branches.gif similarity index 100% rename from docs/media/controlling-conversation-flow/switch-add-branches.gif rename to docs/archived docs/media/controlling-conversation-flow/switch-add-branches.gif diff --git a/docs/media/deployment/BFC-Deploy1.jpg b/docs/archived docs/media/deployment/BFC-Deploy1.jpg similarity index 100% rename from docs/media/deployment/BFC-Deploy1.jpg rename to docs/archived docs/media/deployment/BFC-Deploy1.jpg diff --git a/docs/media/deployment/BFC-Deploy2.jpg b/docs/archived docs/media/deployment/BFC-Deploy2.jpg similarity index 100% rename from docs/media/deployment/BFC-Deploy2.jpg rename to docs/archived docs/media/deployment/BFC-Deploy2.jpg diff --git a/docs/media/deployment/BFC-Deploy3.jpg b/docs/archived docs/media/deployment/BFC-Deploy3.jpg similarity index 100% rename from docs/media/deployment/BFC-Deploy3.jpg rename to docs/archived docs/media/deployment/BFC-Deploy3.jpg diff --git a/docs/media/deployment/create_resource_done.png b/docs/archived docs/media/deployment/create_resource_done.png similarity index 100% rename from docs/media/deployment/create_resource_done.png rename to docs/archived docs/media/deployment/create_resource_done.png diff --git a/docs/media/deployment/publish_success_terminal.png b/docs/archived docs/media/deployment/publish_success_terminal.png similarity index 100% rename from docs/media/deployment/publish_success_terminal.png rename to docs/archived docs/media/deployment/publish_success_terminal.png diff --git a/docs/media/deployment/web_chat.gif b/docs/archived docs/media/deployment/web_chat.gif similarity index 100% rename from docs/media/deployment/web_chat.gif rename to docs/archived docs/media/deployment/web_chat.gif diff --git a/docs/media/dialog/action-menu.gif b/docs/archived docs/media/dialog/action-menu.gif similarity index 100% rename from docs/media/dialog/action-menu.gif rename to docs/archived docs/media/dialog/action-menu.gif diff --git a/docs/media/dialog/adaptive-dialog-anatomy.png b/docs/archived docs/media/dialog/adaptive-dialog-anatomy.png similarity index 100% rename from docs/media/dialog/adaptive-dialog-anatomy.png rename to docs/archived docs/media/dialog/adaptive-dialog-anatomy.png diff --git a/docs/media/dialog/main-and-child-dialog.png b/docs/archived docs/media/dialog/main-and-child-dialog.png similarity index 100% rename from docs/media/dialog/main-and-child-dialog.png rename to docs/archived docs/media/dialog/main-and-child-dialog.png diff --git a/docs/media/dialog/recognizer.png b/docs/archived docs/media/dialog/recognizer.png similarity index 100% rename from docs/media/dialog/recognizer.png rename to docs/archived docs/media/dialog/recognizer.png diff --git a/docs/media/dialog/trigger-menu.png b/docs/archived docs/media/dialog/trigger-menu.png similarity index 100% rename from docs/media/dialog/trigger-menu.png rename to docs/archived docs/media/dialog/trigger-menu.png diff --git a/docs/media/entities/entities.png b/docs/archived docs/media/entities/entities.png similarity index 100% rename from docs/media/entities/entities.png rename to docs/archived docs/media/entities/entities.png diff --git a/docs/media/events-triggers/BookFlight-configure.png b/docs/archived docs/media/events-triggers/BookFlight-configure.png similarity index 100% rename from docs/media/events-triggers/BookFlight-configure.png rename to docs/archived docs/media/events-triggers/BookFlight-configure.png diff --git a/docs/media/events-triggers/LUIS-intent.png b/docs/archived docs/media/events-triggers/LUIS-intent.png similarity index 100% rename from docs/media/events-triggers/LUIS-intent.png rename to docs/archived docs/media/events-triggers/LUIS-intent.png diff --git a/docs/media/events-triggers/activities.png b/docs/archived docs/media/events-triggers/activities.png similarity index 100% rename from docs/media/events-triggers/activities.png rename to docs/archived docs/media/events-triggers/activities.png diff --git a/docs/media/events-triggers/begin-a-new-dialog.png b/docs/archived docs/media/events-triggers/begin-a-new-dialog.png similarity index 100% rename from docs/media/events-triggers/begin-a-new-dialog.png rename to docs/archived docs/media/events-triggers/begin-a-new-dialog.png diff --git a/docs/media/events-triggers/begin-dialog.png b/docs/archived docs/media/events-triggers/begin-dialog.png similarity index 100% rename from docs/media/events-triggers/begin-dialog.png rename to docs/archived docs/media/events-triggers/begin-dialog.png diff --git a/docs/media/events-triggers/cancel-trigger.png b/docs/archived docs/media/events-triggers/cancel-trigger.png similarity index 100% rename from docs/media/events-triggers/cancel-trigger.png rename to docs/archived docs/media/events-triggers/cancel-trigger.png diff --git a/docs/media/events-triggers/conversation-update.png b/docs/archived docs/media/events-triggers/conversation-update.png similarity index 100% rename from docs/media/events-triggers/conversation-update.png rename to docs/archived docs/media/events-triggers/conversation-update.png diff --git a/docs/media/events-triggers/custom-event-property.png b/docs/archived docs/media/events-triggers/custom-event-property.png similarity index 100% rename from docs/media/events-triggers/custom-event-property.png rename to docs/archived docs/media/events-triggers/custom-event-property.png diff --git a/docs/media/events-triggers/custom-event-response.gif b/docs/archived docs/media/events-triggers/custom-event-response.gif similarity index 100% rename from docs/media/events-triggers/custom-event-response.gif rename to docs/archived docs/media/events-triggers/custom-event-response.gif diff --git a/docs/media/events-triggers/custom-event-response.png b/docs/archived docs/media/events-triggers/custom-event-response.png similarity index 100% rename from docs/media/events-triggers/custom-event-response.png rename to docs/archived docs/media/events-triggers/custom-event-response.png diff --git a/docs/media/events-triggers/dialog-events.png b/docs/archived docs/media/events-triggers/dialog-events.png similarity index 100% rename from docs/media/events-triggers/dialog-events.png rename to docs/archived docs/media/events-triggers/dialog-events.png diff --git a/docs/media/events-triggers/emit-custom-event-property.gif b/docs/archived docs/media/events-triggers/emit-custom-event-property.gif similarity index 100% rename from docs/media/events-triggers/emit-custom-event-property.gif rename to docs/archived docs/media/events-triggers/emit-custom-event-property.gif diff --git a/docs/media/events-triggers/emit-custom-event-property.png b/docs/archived docs/media/events-triggers/emit-custom-event-property.png similarity index 100% rename from docs/media/events-triggers/emit-custom-event-property.png rename to docs/archived docs/media/events-triggers/emit-custom-event-property.png diff --git a/docs/media/events-triggers/emit-custom-event.png b/docs/archived docs/media/events-triggers/emit-custom-event.png similarity index 100% rename from docs/media/events-triggers/emit-custom-event.png rename to docs/archived docs/media/events-triggers/emit-custom-event.png diff --git a/docs/media/events-triggers/intent-trigger.png b/docs/archived docs/media/events-triggers/intent-trigger.png similarity index 100% rename from docs/media/events-triggers/intent-trigger.png rename to docs/archived docs/media/events-triggers/intent-trigger.png diff --git a/docs/media/events-triggers/luis-recognizer.png b/docs/archived docs/media/events-triggers/luis-recognizer.png similarity index 100% rename from docs/media/events-triggers/luis-recognizer.png rename to docs/archived docs/media/events-triggers/luis-recognizer.png diff --git a/docs/media/events-triggers/regex-recognizer.png b/docs/archived docs/media/events-triggers/regex-recognizer.png similarity index 100% rename from docs/media/events-triggers/regex-recognizer.png rename to docs/archived docs/media/events-triggers/regex-recognizer.png diff --git a/docs/media/events-triggers/regular-expression-intent.png b/docs/archived docs/media/events-triggers/regular-expression-intent.png similarity index 100% rename from docs/media/events-triggers/regular-expression-intent.png rename to docs/archived docs/media/events-triggers/regular-expression-intent.png diff --git a/docs/media/events-triggers/score.png b/docs/archived docs/media/events-triggers/score.png similarity index 100% rename from docs/media/events-triggers/score.png rename to docs/archived docs/media/events-triggers/score.png diff --git a/docs/media/events-triggers/trigger-menu.gif b/docs/archived docs/media/events-triggers/trigger-menu.gif similarity index 100% rename from docs/media/events-triggers/trigger-menu.gif rename to docs/archived docs/media/events-triggers/trigger-menu.gif diff --git a/docs/media/events-triggers/unknown-intent-response.gif b/docs/archived docs/media/events-triggers/unknown-intent-response.gif similarity index 100% rename from docs/media/events-triggers/unknown-intent-response.gif rename to docs/archived docs/media/events-triggers/unknown-intent-response.gif diff --git a/docs/media/events-triggers/unknown-intent.png b/docs/archived docs/media/events-triggers/unknown-intent.png similarity index 100% rename from docs/media/events-triggers/unknown-intent.png rename to docs/archived docs/media/events-triggers/unknown-intent.png diff --git a/docs/media/events-triggers/welcome.gif b/docs/archived docs/media/events-triggers/welcome.gif similarity index 100% rename from docs/media/events-triggers/welcome.gif rename to docs/archived docs/media/events-triggers/welcome.gif diff --git a/docs/media/events-triggers/wire-up-dialog.gif b/docs/archived docs/media/events-triggers/wire-up-dialog.gif similarity index 100% rename from docs/media/events-triggers/wire-up-dialog.gif rename to docs/archived docs/media/events-triggers/wire-up-dialog.gif diff --git a/docs/media/gh-banner.png b/docs/archived docs/media/gh-banner.png similarity index 100% rename from docs/media/gh-banner.png rename to docs/archived docs/media/gh-banner.png diff --git a/docs/media/integration/composer-oauth-setting.png b/docs/archived docs/media/integration/composer-oauth-setting.png similarity index 100% rename from docs/media/integration/composer-oauth-setting.png rename to docs/archived docs/media/integration/composer-oauth-setting.png diff --git a/docs/media/integration/http-call-success.gif b/docs/archived docs/media/integration/http-call-success.gif similarity index 100% rename from docs/media/integration/http-call-success.gif rename to docs/archived docs/media/integration/http-call-success.gif diff --git a/docs/media/integration/oauth-app-credentials.png b/docs/archived docs/media/integration/oauth-app-credentials.png similarity index 100% rename from docs/media/integration/oauth-app-credentials.png rename to docs/archived docs/media/integration/oauth-app-credentials.png diff --git a/docs/media/integration/oauth-headers.png b/docs/archived docs/media/integration/oauth-headers.png similarity index 100% rename from docs/media/integration/oauth-headers.png rename to docs/archived docs/media/integration/oauth-headers.png diff --git a/docs/media/integration/oauth-login-properties.png b/docs/archived docs/media/integration/oauth-login-properties.png similarity index 100% rename from docs/media/integration/oauth-login-properties.png rename to docs/archived docs/media/integration/oauth-login-properties.png diff --git a/docs/media/integration/oauth-menu.png b/docs/archived docs/media/integration/oauth-menu.png similarity index 100% rename from docs/media/integration/oauth-menu.png rename to docs/archived docs/media/integration/oauth-menu.png diff --git a/docs/media/integration/oauth-response-to-test.png b/docs/archived docs/media/integration/oauth-response-to-test.png similarity index 100% rename from docs/media/integration/oauth-response-to-test.png rename to docs/archived docs/media/integration/oauth-response-to-test.png diff --git a/docs/media/integration/oauth-setup.png b/docs/archived docs/media/integration/oauth-setup.png similarity index 100% rename from docs/media/integration/oauth-setup.png rename to docs/archived docs/media/integration/oauth-setup.png diff --git a/docs/media/integration/oauth-test-token.png b/docs/archived docs/media/integration/oauth-test-token.png similarity index 100% rename from docs/media/integration/oauth-test-token.png rename to docs/archived docs/media/integration/oauth-test-token.png diff --git a/docs/media/integration/qna-maker-begin-integration.png b/docs/archived docs/media/integration/qna-maker-begin-integration.png similarity index 100% rename from docs/media/integration/qna-maker-begin-integration.png rename to docs/archived docs/media/integration/qna-maker-begin-integration.png diff --git a/docs/media/integration/qna-maker-edit-settings.png b/docs/archived docs/media/integration/qna-maker-edit-settings.png similarity index 100% rename from docs/media/integration/qna-maker-edit-settings.png rename to docs/archived docs/media/integration/qna-maker-edit-settings.png diff --git a/docs/media/integration/qna-maker-review-settings.png b/docs/archived docs/media/integration/qna-maker-review-settings.png similarity index 100% rename from docs/media/integration/qna-maker-review-settings.png rename to docs/archived docs/media/integration/qna-maker-review-settings.png diff --git a/docs/media/integration/register-github-oauth-app.png b/docs/archived docs/media/integration/register-github-oauth-app.png similarity index 100% rename from docs/media/integration/register-github-oauth-app.png rename to docs/archived docs/media/integration/register-github-oauth-app.png diff --git a/docs/media/introduction/Bot-Responses.png b/docs/archived docs/media/introduction/Bot-Responses.png similarity index 100% rename from docs/media/introduction/Bot-Responses.png rename to docs/archived docs/media/introduction/Bot-Responses.png diff --git a/docs/media/introduction/bf-composer-lg.png b/docs/archived docs/media/introduction/bf-composer-lg.png similarity index 100% rename from docs/media/introduction/bf-composer-lg.png rename to docs/archived docs/media/introduction/bf-composer-lg.png diff --git a/docs/media/introduction/composer-overview.png b/docs/archived docs/media/introduction/composer-overview.png similarity index 100% rename from docs/media/introduction/composer-overview.png rename to docs/archived docs/media/introduction/composer-overview.png diff --git a/docs/media/introduction/intro-nlu.png b/docs/archived docs/media/introduction/intro-nlu.png similarity index 100% rename from docs/media/introduction/intro-nlu.png rename to docs/archived docs/media/introduction/intro-nlu.png diff --git a/docs/media/introduction/overview.png b/docs/archived docs/media/introduction/overview.png similarity index 100% rename from docs/media/introduction/overview.png rename to docs/archived docs/media/introduction/overview.png diff --git a/docs/media/language-generation/Bot-Responses.png b/docs/archived docs/media/language-generation/Bot-Responses.png similarity index 100% rename from docs/media/language-generation/Bot-Responses.png rename to docs/archived docs/media/language-generation/Bot-Responses.png diff --git a/docs/media/language-generation/lg-inline-editor.png b/docs/archived docs/media/language-generation/lg-inline-editor.png similarity index 100% rename from docs/media/language-generation/lg-inline-editor.png rename to docs/archived docs/media/language-generation/lg-inline-editor.png diff --git a/docs/media/language-understanding/LU-content.png b/docs/archived docs/media/language-understanding/LU-content.png similarity index 100% rename from docs/media/language-understanding/LU-content.png rename to docs/archived docs/media/language-understanding/LU-content.png diff --git a/docs/media/language-understanding/publish-lu.png b/docs/archived docs/media/language-understanding/publish-lu.png similarity index 100% rename from docs/media/language-understanding/publish-lu.png rename to docs/archived docs/media/language-understanding/publish-lu.png diff --git a/docs/media/language-understanding/select-recognizer.png b/docs/archived docs/media/language-understanding/select-recognizer.png similarity index 100% rename from docs/media/language-understanding/select-recognizer.png rename to docs/archived docs/media/language-understanding/select-recognizer.png diff --git a/docs/media/language-understanding/user-input.png b/docs/archived docs/media/language-understanding/user-input.png similarity index 100% rename from docs/media/language-understanding/user-input.png rename to docs/archived docs/media/language-understanding/user-input.png diff --git a/docs/media/language-understanding/wireup-intent.png b/docs/archived docs/media/language-understanding/wireup-intent.png similarity index 100% rename from docs/media/language-understanding/wireup-intent.png rename to docs/archived docs/media/language-understanding/wireup-intent.png diff --git a/docs/media/memory/ask-a-question-menu.png b/docs/archived docs/media/memory/ask-a-question-menu.png similarity index 100% rename from docs/media/memory/ask-a-question-menu.png rename to docs/archived docs/media/memory/ask-a-question-menu.png diff --git a/docs/media/memory/begin-new-dialog.png b/docs/archived docs/media/memory/begin-new-dialog.png similarity index 100% rename from docs/media/memory/begin-new-dialog.png rename to docs/archived docs/media/memory/begin-new-dialog.png diff --git a/docs/media/memory/blank b/docs/archived docs/media/memory/blank similarity index 100% rename from docs/media/memory/blank rename to docs/archived docs/media/memory/blank diff --git a/docs/media/memory/bot-asks.png b/docs/archived docs/media/memory/bot-asks.png similarity index 100% rename from docs/media/memory/bot-asks.png rename to docs/archived docs/media/memory/bot-asks.png diff --git a/docs/media/memory/default-result-property.png b/docs/archived docs/media/memory/default-result-property.png similarity index 100% rename from docs/media/memory/default-result-property.png rename to docs/archived docs/media/memory/default-result-property.png diff --git a/docs/media/memory/delete-properties.png b/docs/archived docs/media/memory/delete-properties.png similarity index 100% rename from docs/media/memory/delete-properties.png rename to docs/archived docs/media/memory/delete-properties.png diff --git a/docs/media/memory/delete-property.png b/docs/archived docs/media/memory/delete-property.png similarity index 100% rename from docs/media/memory/delete-property.png rename to docs/archived docs/media/memory/delete-property.png diff --git a/docs/media/memory/edit-array-property.png b/docs/archived docs/media/memory/edit-array-property.png similarity index 100% rename from docs/media/memory/edit-array-property.png rename to docs/archived docs/media/memory/edit-array-property.png diff --git a/docs/media/memory/for-each.png b/docs/archived docs/media/memory/for-each.png similarity index 100% rename from docs/media/memory/for-each.png rename to docs/archived docs/media/memory/for-each.png diff --git a/docs/media/memory/if-else.png b/docs/archived docs/media/memory/if-else.png similarity index 100% rename from docs/media/memory/if-else.png rename to docs/archived docs/media/memory/if-else.png diff --git a/docs/media/memory/initialize-object-profile.png b/docs/archived docs/media/memory/initialize-object-profile.png similarity index 100% rename from docs/media/memory/initialize-object-profile.png rename to docs/archived docs/media/memory/initialize-object-profile.png diff --git a/docs/media/memory/initialize-property.png b/docs/archived docs/media/memory/initialize-property.png similarity index 100% rename from docs/media/memory/initialize-property.png rename to docs/archived docs/media/memory/initialize-property.png diff --git a/docs/media/memory/lg.png b/docs/archived docs/media/memory/lg.png similarity index 100% rename from docs/media/memory/lg.png rename to docs/archived docs/media/memory/lg.png diff --git a/docs/media/memory/memory-mainpulation-menu.png b/docs/archived docs/media/memory/memory-mainpulation-menu.png similarity index 100% rename from docs/media/memory/memory-mainpulation-menu.png rename to docs/archived docs/media/memory/memory-mainpulation-menu.png diff --git a/docs/media/memory/set-properties.png b/docs/archived docs/media/memory/set-properties.png similarity index 100% rename from docs/media/memory/set-properties.png rename to docs/archived docs/media/memory/set-properties.png diff --git a/docs/media/memory/set-property.png b/docs/archived docs/media/memory/set-property.png similarity index 100% rename from docs/media/memory/set-property.png rename to docs/archived docs/media/memory/set-property.png diff --git a/docs/media/memory/switch.png b/docs/archived docs/media/memory/switch.png similarity index 100% rename from docs/media/memory/switch.png rename to docs/archived docs/media/memory/switch.png diff --git a/docs/media/memory/user-input.png b/docs/archived docs/media/memory/user-input.png similarity index 100% rename from docs/media/memory/user-input.png rename to docs/archived docs/media/memory/user-input.png diff --git a/docs/media/onboarding/enable-onboarding.png b/docs/archived docs/media/onboarding/enable-onboarding.png similarity index 100% rename from docs/media/onboarding/enable-onboarding.png rename to docs/archived docs/media/onboarding/enable-onboarding.png diff --git a/docs/media/onboarding/leave-product-tour.png b/docs/archived docs/media/onboarding/leave-product-tour.png similarity index 100% rename from docs/media/onboarding/leave-product-tour.png rename to docs/archived docs/media/onboarding/leave-product-tour.png diff --git a/docs/media/onboarding/onboarding-popup.png b/docs/archived docs/media/onboarding/onboarding-popup.png similarity index 100% rename from docs/media/onboarding/onboarding-popup.png rename to docs/archived docs/media/onboarding/onboarding-popup.png diff --git a/docs/media/onboarding/previous-next.png b/docs/archived docs/media/onboarding/previous-next.png similarity index 100% rename from docs/media/onboarding/previous-next.png rename to docs/archived docs/media/onboarding/previous-next.png diff --git a/docs/media/send_messages/LG_composition.png b/docs/archived docs/media/send_messages/LG_composition.png similarity index 100% rename from docs/media/send_messages/LG_composition.png rename to docs/archived docs/media/send_messages/LG_composition.png diff --git a/docs/media/send_messages/LG_parameter.png b/docs/archived docs/media/send_messages/LG_parameter.png similarity index 100% rename from docs/media/send_messages/LG_parameter.png rename to docs/archived docs/media/send_messages/LG_parameter.png diff --git a/docs/media/send_messages/send_response.png b/docs/archived docs/media/send_messages/send_response.png similarity index 100% rename from docs/media/send_messages/send_response.png rename to docs/archived docs/media/send_messages/send_response.png diff --git a/docs/media/send_messages/simple_text.png b/docs/archived docs/media/send_messages/simple_text.png similarity index 100% rename from docs/media/send_messages/simple_text.png rename to docs/archived docs/media/send_messages/simple_text.png diff --git a/docs/media/send_messages/text_LG.png b/docs/archived docs/media/send_messages/text_LG.png similarity index 100% rename from docs/media/send_messages/text_LG.png rename to docs/archived docs/media/send_messages/text_LG.png diff --git a/docs/media/send_messages/text_memory.png b/docs/archived docs/media/send_messages/text_memory.png similarity index 100% rename from docs/media/send_messages/text_memory.png rename to docs/archived docs/media/send_messages/text_memory.png diff --git a/docs/media/setup-yarn/address.png b/docs/archived docs/media/setup-yarn/address.png similarity index 100% rename from docs/media/setup-yarn/address.png rename to docs/archived docs/media/setup-yarn/address.png diff --git a/docs/media/setup-yarn/blank b/docs/archived docs/media/setup-yarn/blank similarity index 100% rename from docs/media/setup-yarn/blank rename to docs/archived docs/media/setup-yarn/blank diff --git a/docs/media/skill/Begin-a-skill-event.png b/docs/archived docs/media/skill/Begin-a-skill-event.png similarity index 100% rename from docs/media/skill/Begin-a-skill-event.png rename to docs/archived docs/media/skill/Begin-a-skill-event.png diff --git a/docs/media/skill/Begin-a-skill-message.png b/docs/archived docs/media/skill/Begin-a-skill-message.png similarity index 100% rename from docs/media/skill/Begin-a-skill-message.png rename to docs/archived docs/media/skill/Begin-a-skill-message.png diff --git a/docs/media/skill/Begin-a-skill.png b/docs/archived docs/media/skill/Begin-a-skill.png similarity index 100% rename from docs/media/skill/Begin-a-skill.png rename to docs/archived docs/media/skill/Begin-a-skill.png diff --git a/docs/media/tutorial-echobot/echo-new.png b/docs/archived docs/media/tutorial-echobot/echo-new.png similarity index 100% rename from docs/media/tutorial-echobot/echo-new.png rename to docs/archived docs/media/tutorial-echobot/echo-new.png diff --git a/docs/media/tutorial-echobot/echo-select.png b/docs/archived docs/media/tutorial-echobot/echo-select.png similarity index 100% rename from docs/media/tutorial-echobot/echo-select.png rename to docs/archived docs/media/tutorial-echobot/echo-select.png diff --git a/docs/media/tutorial-echobot/select-none-recognizer.gif b/docs/archived docs/media/tutorial-echobot/select-none-recognizer.gif similarity index 100% rename from docs/media/tutorial-echobot/select-none-recognizer.gif rename to docs/archived docs/media/tutorial-echobot/select-none-recognizer.gif diff --git a/docs/media/tutorial-echobot/start-bot.gif b/docs/archived docs/media/tutorial-echobot/start-bot.gif similarity index 100% rename from docs/media/tutorial-echobot/start-bot.gif rename to docs/archived docs/media/tutorial-echobot/start-bot.gif diff --git a/docs/media/tutorial-echobot/test-emulator.gif b/docs/archived docs/media/tutorial-echobot/test-emulator.gif similarity index 100% rename from docs/media/tutorial-echobot/test-emulator.gif rename to docs/archived docs/media/tutorial-echobot/test-emulator.gif diff --git a/docs/media/tutorial-echobot/tutorial-echo-setup.png b/docs/archived docs/media/tutorial-echobot/tutorial-echo-setup.png similarity index 100% rename from docs/media/tutorial-echobot/tutorial-echo-setup.png rename to docs/archived docs/media/tutorial-echobot/tutorial-echo-setup.png diff --git a/docs/media/tutorial-weatherbot/01/WelcomeTheUser.gif b/docs/archived docs/media/tutorial-weatherbot/01/WelcomeTheUser.gif similarity index 100% rename from docs/media/tutorial-weatherbot/01/WelcomeTheUser.gif rename to docs/archived docs/media/tutorial-weatherbot/01/WelcomeTheUser.gif diff --git a/docs/media/tutorial-weatherbot/01/create-1.png b/docs/archived docs/media/tutorial-weatherbot/01/create-1.png similarity index 100% rename from docs/media/tutorial-weatherbot/01/create-1.png rename to docs/archived docs/media/tutorial-weatherbot/01/create-1.png diff --git a/docs/media/tutorial-weatherbot/01/create-2.png b/docs/archived docs/media/tutorial-weatherbot/01/create-2.png similarity index 100% rename from docs/media/tutorial-weatherbot/01/create-2.png rename to docs/archived docs/media/tutorial-weatherbot/01/create-2.png diff --git a/docs/media/tutorial-weatherbot/01/empty-main-dialog.png b/docs/archived docs/media/tutorial-weatherbot/01/empty-main-dialog.png similarity index 100% rename from docs/media/tutorial-weatherbot/01/empty-main-dialog.png rename to docs/archived docs/media/tutorial-weatherbot/01/empty-main-dialog.png diff --git a/docs/media/tutorial-weatherbot/01/emulator-launch.png b/docs/archived docs/media/tutorial-weatherbot/01/emulator-launch.png similarity index 100% rename from docs/media/tutorial-weatherbot/01/emulator-launch.png rename to docs/archived docs/media/tutorial-weatherbot/01/emulator-launch.png diff --git a/docs/media/tutorial-weatherbot/01/new.png b/docs/archived docs/media/tutorial-weatherbot/01/new.png similarity index 100% rename from docs/media/tutorial-weatherbot/01/new.png rename to docs/archived docs/media/tutorial-weatherbot/01/new.png diff --git a/docs/media/tutorial-weatherbot/01/rename-trigger.gif b/docs/archived docs/media/tutorial-weatherbot/01/rename-trigger.gif similarity index 100% rename from docs/media/tutorial-weatherbot/01/rename-trigger.gif rename to docs/archived docs/media/tutorial-weatherbot/01/rename-trigger.gif diff --git a/docs/media/tutorial-weatherbot/01/send-activity.gif b/docs/archived docs/media/tutorial-weatherbot/01/send-activity.gif similarity index 100% rename from docs/media/tutorial-weatherbot/01/send-activity.gif rename to docs/archived docs/media/tutorial-weatherbot/01/send-activity.gif diff --git a/docs/media/tutorial-weatherbot/01/start-bot.gif b/docs/archived docs/media/tutorial-weatherbot/01/start-bot.gif similarity index 100% rename from docs/media/tutorial-weatherbot/01/start-bot.gif rename to docs/archived docs/media/tutorial-weatherbot/01/start-bot.gif diff --git a/docs/media/tutorial-weatherbot/02/begin-dialog.png b/docs/archived docs/media/tutorial-weatherbot/02/begin-dialog.png similarity index 100% rename from docs/media/tutorial-weatherbot/02/begin-dialog.png rename to docs/archived docs/media/tutorial-weatherbot/02/begin-dialog.png diff --git a/docs/media/tutorial-weatherbot/02/connect-dialog.png b/docs/archived docs/media/tutorial-weatherbot/02/connect-dialog.png similarity index 100% rename from docs/media/tutorial-weatherbot/02/connect-dialog.png rename to docs/archived docs/media/tutorial-weatherbot/02/connect-dialog.png diff --git a/docs/media/tutorial-weatherbot/02/create-getweather-dialog.png b/docs/archived docs/media/tutorial-weatherbot/02/create-getweather-dialog.png similarity index 100% rename from docs/media/tutorial-weatherbot/02/create-getweather-dialog.png rename to docs/archived docs/media/tutorial-weatherbot/02/create-getweather-dialog.png diff --git a/docs/media/tutorial-weatherbot/02/dialog-management.png b/docs/archived docs/media/tutorial-weatherbot/02/dialog-management.png similarity index 100% rename from docs/media/tutorial-weatherbot/02/dialog-management.png rename to docs/archived docs/media/tutorial-weatherbot/02/dialog-management.png diff --git a/docs/media/tutorial-weatherbot/02/emulator-weather.png b/docs/archived docs/media/tutorial-weatherbot/02/emulator-weather.png similarity index 100% rename from docs/media/tutorial-weatherbot/02/emulator-weather.png rename to docs/archived docs/media/tutorial-weatherbot/02/emulator-weather.png diff --git a/docs/media/tutorial-weatherbot/02/getweather-dialog.gif b/docs/archived docs/media/tutorial-weatherbot/02/getweather-dialog.gif similarity index 100% rename from docs/media/tutorial-weatherbot/02/getweather-dialog.gif rename to docs/archived docs/media/tutorial-weatherbot/02/getweather-dialog.gif diff --git a/docs/media/tutorial-weatherbot/02/intent-pattern.png b/docs/archived docs/media/tutorial-weatherbot/02/intent-pattern.png similarity index 100% rename from docs/media/tutorial-weatherbot/02/intent-pattern.png rename to docs/archived docs/media/tutorial-weatherbot/02/intent-pattern.png diff --git a/docs/media/tutorial-weatherbot/02/recognizer-type.png b/docs/archived docs/media/tutorial-weatherbot/02/recognizer-type.png similarity index 100% rename from docs/media/tutorial-weatherbot/02/recognizer-type.png rename to docs/archived docs/media/tutorial-weatherbot/02/recognizer-type.png diff --git a/docs/media/tutorial-weatherbot/02/restart-bot.gif b/docs/archived docs/media/tutorial-weatherbot/02/restart-bot.gif similarity index 100% rename from docs/media/tutorial-weatherbot/02/restart-bot.gif rename to docs/archived docs/media/tutorial-weatherbot/02/restart-bot.gif diff --git a/docs/media/tutorial-weatherbot/02/weather-intent-trigger.png b/docs/archived docs/media/tutorial-weatherbot/02/weather-intent-trigger.png similarity index 100% rename from docs/media/tutorial-weatherbot/02/weather-intent-trigger.png rename to docs/archived docs/media/tutorial-weatherbot/02/weather-intent-trigger.png diff --git a/docs/media/tutorial-weatherbot/03/basic-weather.gif b/docs/archived docs/media/tutorial-weatherbot/03/basic-weather.gif similarity index 100% rename from docs/media/tutorial-weatherbot/03/basic-weather.gif rename to docs/archived docs/media/tutorial-weatherbot/03/basic-weather.gif diff --git a/docs/media/tutorial-weatherbot/03/http-result-property.png b/docs/archived docs/media/tutorial-weatherbot/03/http-result-property.png similarity index 100% rename from docs/media/tutorial-weatherbot/03/http-result-property.png rename to docs/archived docs/media/tutorial-weatherbot/03/http-result-property.png diff --git a/docs/media/tutorial-weatherbot/03/http-step.png b/docs/archived docs/media/tutorial-weatherbot/03/http-step.png similarity index 100% rename from docs/media/tutorial-weatherbot/03/http-step.png rename to docs/archived docs/media/tutorial-weatherbot/03/http-step.png diff --git a/docs/media/tutorial-weatherbot/03/http-url.png b/docs/archived docs/media/tutorial-weatherbot/03/http-url.png similarity index 100% rename from docs/media/tutorial-weatherbot/03/http-url.png rename to docs/archived docs/media/tutorial-weatherbot/03/http-url.png diff --git a/docs/media/tutorial-weatherbot/03/ifelse.png b/docs/archived docs/media/tutorial-weatherbot/03/ifelse.png similarity index 100% rename from docs/media/tutorial-weatherbot/03/ifelse.png rename to docs/archived docs/media/tutorial-weatherbot/03/ifelse.png diff --git a/docs/media/tutorial-weatherbot/03/ifelse2.png b/docs/archived docs/media/tutorial-weatherbot/03/ifelse2.png similarity index 100% rename from docs/media/tutorial-weatherbot/03/ifelse2.png rename to docs/archived docs/media/tutorial-weatherbot/03/ifelse2.png diff --git a/docs/media/tutorial-weatherbot/03/set-a-property.png b/docs/archived docs/media/tutorial-weatherbot/03/set-a-property.png similarity index 100% rename from docs/media/tutorial-weatherbot/03/set-a-property.png rename to docs/archived docs/media/tutorial-weatherbot/03/set-a-property.png diff --git a/docs/media/tutorial-weatherbot/03/set-property-condition.png b/docs/archived docs/media/tutorial-weatherbot/03/set-property-condition.png similarity index 100% rename from docs/media/tutorial-weatherbot/03/set-property-condition.png rename to docs/archived docs/media/tutorial-weatherbot/03/set-property-condition.png diff --git a/docs/media/tutorial-weatherbot/03/user-prompts.png b/docs/archived docs/media/tutorial-weatherbot/03/user-prompts.png similarity index 100% rename from docs/media/tutorial-weatherbot/03/user-prompts.png rename to docs/archived docs/media/tutorial-weatherbot/03/user-prompts.png diff --git a/docs/media/tutorial-weatherbot/03/zipcode-answer.png b/docs/archived docs/media/tutorial-weatherbot/03/zipcode-answer.png similarity index 100% rename from docs/media/tutorial-weatherbot/03/zipcode-answer.png rename to docs/archived docs/media/tutorial-weatherbot/03/zipcode-answer.png diff --git a/docs/media/tutorial-weatherbot/03/zipcode-extensions.png b/docs/archived docs/media/tutorial-weatherbot/03/zipcode-extensions.png similarity index 100% rename from docs/media/tutorial-weatherbot/03/zipcode-extensions.png rename to docs/archived docs/media/tutorial-weatherbot/03/zipcode-extensions.png diff --git a/docs/media/tutorial-weatherbot/03/zipcode-prompt.png b/docs/archived docs/media/tutorial-weatherbot/03/zipcode-prompt.png similarity index 100% rename from docs/media/tutorial-weatherbot/03/zipcode-prompt.png rename to docs/archived docs/media/tutorial-weatherbot/03/zipcode-prompt.png diff --git a/docs/media/tutorial-weatherbot/04/basic-help.gif b/docs/archived docs/media/tutorial-weatherbot/04/basic-help.gif similarity index 100% rename from docs/media/tutorial-weatherbot/04/basic-help.gif rename to docs/archived docs/media/tutorial-weatherbot/04/basic-help.gif diff --git a/docs/media/tutorial-weatherbot/04/begin-new-dialog-cancel.png b/docs/archived docs/media/tutorial-weatherbot/04/begin-new-dialog-cancel.png similarity index 100% rename from docs/media/tutorial-weatherbot/04/begin-new-dialog-cancel.png rename to docs/archived docs/media/tutorial-weatherbot/04/begin-new-dialog-cancel.png diff --git a/docs/media/tutorial-weatherbot/04/begin-new-dialog.png b/docs/archived docs/media/tutorial-weatherbot/04/begin-new-dialog.png similarity index 100% rename from docs/media/tutorial-weatherbot/04/begin-new-dialog.png rename to docs/archived docs/media/tutorial-weatherbot/04/begin-new-dialog.png diff --git a/docs/media/tutorial-weatherbot/04/better-help.gif b/docs/archived docs/media/tutorial-weatherbot/04/better-help.gif similarity index 100% rename from docs/media/tutorial-weatherbot/04/better-help.gif rename to docs/archived docs/media/tutorial-weatherbot/04/better-help.gif diff --git a/docs/media/tutorial-weatherbot/04/cancel-flow.png b/docs/archived docs/media/tutorial-weatherbot/04/cancel-flow.png similarity index 100% rename from docs/media/tutorial-weatherbot/04/cancel-flow.png rename to docs/archived docs/media/tutorial-weatherbot/04/cancel-flow.png diff --git a/docs/media/tutorial-weatherbot/04/cancel-intent.png b/docs/archived docs/media/tutorial-weatherbot/04/cancel-intent.png similarity index 100% rename from docs/media/tutorial-weatherbot/04/cancel-intent.png rename to docs/archived docs/media/tutorial-weatherbot/04/cancel-intent.png diff --git a/docs/media/tutorial-weatherbot/04/cancel-trigger.png b/docs/archived docs/media/tutorial-weatherbot/04/cancel-trigger.png similarity index 100% rename from docs/media/tutorial-weatherbot/04/cancel-trigger.png rename to docs/archived docs/media/tutorial-weatherbot/04/cancel-trigger.png diff --git a/docs/media/tutorial-weatherbot/04/help-dialog.png b/docs/archived docs/media/tutorial-weatherbot/04/help-dialog.png similarity index 100% rename from docs/media/tutorial-weatherbot/04/help-dialog.png rename to docs/archived docs/media/tutorial-weatherbot/04/help-dialog.png diff --git a/docs/media/tutorial-weatherbot/04/help-intent.png b/docs/archived docs/media/tutorial-weatherbot/04/help-intent.png similarity index 100% rename from docs/media/tutorial-weatherbot/04/help-intent.png rename to docs/archived docs/media/tutorial-weatherbot/04/help-intent.png diff --git a/docs/media/tutorial-weatherbot/04/help.png b/docs/archived docs/media/tutorial-weatherbot/04/help.png similarity index 100% rename from docs/media/tutorial-weatherbot/04/help.png rename to docs/archived docs/media/tutorial-weatherbot/04/help.png diff --git a/docs/media/tutorial-weatherbot/04/intent-trigger-cancel.png b/docs/archived docs/media/tutorial-weatherbot/04/intent-trigger-cancel.png similarity index 100% rename from docs/media/tutorial-weatherbot/04/intent-trigger-cancel.png rename to docs/archived docs/media/tutorial-weatherbot/04/intent-trigger-cancel.png diff --git a/docs/media/tutorial-weatherbot/04/intent-trigger-help.png b/docs/archived docs/media/tutorial-weatherbot/04/intent-trigger-help.png similarity index 100% rename from docs/media/tutorial-weatherbot/04/intent-trigger-help.png rename to docs/archived docs/media/tutorial-weatherbot/04/intent-trigger-help.png diff --git a/docs/media/tutorial-weatherbot/04/interrupts.png b/docs/archived docs/media/tutorial-weatherbot/04/interrupts.png similarity index 100% rename from docs/media/tutorial-weatherbot/04/interrupts.png rename to docs/archived docs/media/tutorial-weatherbot/04/interrupts.png diff --git a/docs/media/tutorial-weatherbot/04/new_trigger.png b/docs/archived docs/media/tutorial-weatherbot/04/new_trigger.png similarity index 100% rename from docs/media/tutorial-weatherbot/04/new_trigger.png rename to docs/archived docs/media/tutorial-weatherbot/04/new_trigger.png diff --git a/docs/media/tutorial-weatherbot/04/plus-sign-icon.png b/docs/archived docs/media/tutorial-weatherbot/04/plus-sign-icon.png similarity index 100% rename from docs/media/tutorial-weatherbot/04/plus-sign-icon.png rename to docs/archived docs/media/tutorial-weatherbot/04/plus-sign-icon.png diff --git a/docs/media/tutorial-weatherbot/04/select-begindialog-trigger.png b/docs/archived docs/media/tutorial-weatherbot/04/select-begindialog-trigger.png similarity index 100% rename from docs/media/tutorial-weatherbot/04/select-begindialog-trigger.png rename to docs/archived docs/media/tutorial-weatherbot/04/select-begindialog-trigger.png diff --git a/docs/media/tutorial-weatherbot/04/select-cancel-dialog.png b/docs/archived docs/media/tutorial-weatherbot/04/select-cancel-dialog.png similarity index 100% rename from docs/media/tutorial-weatherbot/04/select-cancel-dialog.png rename to docs/archived docs/media/tutorial-weatherbot/04/select-cancel-dialog.png diff --git a/docs/media/tutorial-weatherbot/04/select-help-dialog.png b/docs/archived docs/media/tutorial-weatherbot/04/select-help-dialog.png similarity index 100% rename from docs/media/tutorial-weatherbot/04/select-help-dialog.png rename to docs/archived docs/media/tutorial-weatherbot/04/select-help-dialog.png diff --git a/docs/media/tutorial-weatherbot/04/select-textinput-action.png b/docs/archived docs/media/tutorial-weatherbot/04/select-textinput-action.png similarity index 100% rename from docs/media/tutorial-weatherbot/04/select-textinput-action.png rename to docs/archived docs/media/tutorial-weatherbot/04/select-textinput-action.png diff --git a/docs/media/tutorial-weatherbot/05/Select-the-BeginDialog-trigger.png b/docs/archived docs/media/tutorial-weatherbot/05/Select-the-BeginDialog-trigger.png similarity index 100% rename from docs/media/tutorial-weatherbot/05/Select-the-BeginDialog-trigger.png rename to docs/archived docs/media/tutorial-weatherbot/05/Select-the-BeginDialog-trigger.png diff --git a/docs/media/tutorial-weatherbot/05/bot-responses.png b/docs/archived docs/media/tutorial-weatherbot/05/bot-responses.png similarity index 100% rename from docs/media/tutorial-weatherbot/05/bot-responses.png rename to docs/archived docs/media/tutorial-weatherbot/05/bot-responses.png diff --git a/docs/media/tutorial-weatherbot/05/botsays.png b/docs/archived docs/media/tutorial-weatherbot/05/botsays.png similarity index 100% rename from docs/media/tutorial-weatherbot/05/botsays.png rename to docs/archived docs/media/tutorial-weatherbot/05/botsays.png diff --git a/docs/media/tutorial-weatherbot/05/editmode.png b/docs/archived docs/media/tutorial-weatherbot/05/editmode.png similarity index 100% rename from docs/media/tutorial-weatherbot/05/editmode.png rename to docs/archived docs/media/tutorial-weatherbot/05/editmode.png diff --git a/docs/media/tutorial-weatherbot/05/lg-1.png b/docs/archived docs/media/tutorial-weatherbot/05/lg-1.png similarity index 100% rename from docs/media/tutorial-weatherbot/05/lg-1.png rename to docs/archived docs/media/tutorial-weatherbot/05/lg-1.png diff --git a/docs/media/tutorial-weatherbot/05/lg-2.png b/docs/archived docs/media/tutorial-weatherbot/05/lg-2.png similarity index 100% rename from docs/media/tutorial-weatherbot/05/lg-2.png rename to docs/archived docs/media/tutorial-weatherbot/05/lg-2.png diff --git a/docs/media/tutorial-weatherbot/05/nav1.png b/docs/archived docs/media/tutorial-weatherbot/05/nav1.png similarity index 100% rename from docs/media/tutorial-weatherbot/05/nav1.png rename to docs/archived docs/media/tutorial-weatherbot/05/nav1.png diff --git a/docs/media/tutorial-weatherbot/05/nice-weather.png b/docs/archived docs/media/tutorial-weatherbot/05/nice-weather.png similarity index 100% rename from docs/media/tutorial-weatherbot/05/nice-weather.png rename to docs/archived docs/media/tutorial-weatherbot/05/nice-weather.png diff --git a/docs/media/tutorial-weatherbot/05/select-the-WelcomeTheUser-trigger.png b/docs/archived docs/media/tutorial-weatherbot/05/select-the-WelcomeTheUser-trigger.png similarity index 100% rename from docs/media/tutorial-weatherbot/05/select-the-WelcomeTheUser-trigger.png rename to docs/archived docs/media/tutorial-weatherbot/05/select-the-WelcomeTheUser-trigger.png diff --git a/docs/media/tutorial-weatherbot/06/getWeather-beginDialog.png b/docs/archived docs/media/tutorial-weatherbot/06/getWeather-beginDialog.png similarity index 100% rename from docs/media/tutorial-weatherbot/06/getWeather-beginDialog.png rename to docs/archived docs/media/tutorial-weatherbot/06/getWeather-beginDialog.png diff --git a/docs/media/tutorial-weatherbot/06/getWeather-beginDialog2.png b/docs/archived docs/media/tutorial-weatherbot/06/getWeather-beginDialog2.png similarity index 100% rename from docs/media/tutorial-weatherbot/06/getWeather-beginDialog2.png rename to docs/archived docs/media/tutorial-weatherbot/06/getWeather-beginDialog2.png diff --git a/docs/media/tutorial-weatherbot/06/suggested-actions-emulator.png b/docs/archived docs/media/tutorial-weatherbot/06/suggested-actions-emulator.png similarity index 100% rename from docs/media/tutorial-weatherbot/06/suggested-actions-emulator.png rename to docs/archived docs/media/tutorial-weatherbot/06/suggested-actions-emulator.png diff --git a/docs/media/tutorial-weatherbot/06/weather-card.png b/docs/archived docs/media/tutorial-weatherbot/06/weather-card.png similarity index 100% rename from docs/media/tutorial-weatherbot/06/weather-card.png rename to docs/archived docs/media/tutorial-weatherbot/06/weather-card.png diff --git a/docs/media/tutorial-weatherbot/06/zipcode-prompt.png b/docs/archived docs/media/tutorial-weatherbot/06/zipcode-prompt.png similarity index 100% rename from docs/media/tutorial-weatherbot/06/zipcode-prompt.png rename to docs/archived docs/media/tutorial-weatherbot/06/zipcode-prompt.png diff --git a/docs/media/tutorial-weatherbot/07/back-at-zipcode-prompt.png b/docs/archived docs/media/tutorial-weatherbot/07/back-at-zipcode-prompt.png similarity index 100% rename from docs/media/tutorial-weatherbot/07/back-at-zipcode-prompt.png rename to docs/archived docs/media/tutorial-weatherbot/07/back-at-zipcode-prompt.png diff --git a/docs/media/tutorial-weatherbot/07/luis-key.png b/docs/archived docs/media/tutorial-weatherbot/07/luis-key.png similarity index 100% rename from docs/media/tutorial-weatherbot/07/luis-key.png rename to docs/archived docs/media/tutorial-weatherbot/07/luis-key.png diff --git a/docs/media/tutorial-weatherbot/07/luis-recognizer.png b/docs/archived docs/media/tutorial-weatherbot/07/luis-recognizer.png similarity index 100% rename from docs/media/tutorial-weatherbot/07/luis-recognizer.png rename to docs/archived docs/media/tutorial-weatherbot/07/luis-recognizer.png diff --git a/docs/media/tutorial-weatherbot/07/luis-score.png b/docs/archived docs/media/tutorial-weatherbot/07/luis-score.png similarity index 100% rename from docs/media/tutorial-weatherbot/07/luis-score.png rename to docs/archived docs/media/tutorial-weatherbot/07/luis-score.png diff --git a/docs/media/tutorial-weatherbot/07/luis-wired-up.png b/docs/archived docs/media/tutorial-weatherbot/07/luis-wired-up.png similarity index 100% rename from docs/media/tutorial-weatherbot/07/luis-wired-up.png rename to docs/archived docs/media/tutorial-weatherbot/07/luis-wired-up.png diff --git a/docs/media/tutorial-weatherbot/07/luis-with-lu-content.png b/docs/archived docs/media/tutorial-weatherbot/07/luis-with-lu-content.png similarity index 100% rename from docs/media/tutorial-weatherbot/07/luis-with-lu-content.png rename to docs/archived docs/media/tutorial-weatherbot/07/luis-with-lu-content.png diff --git a/docs/media/tutorial-weatherbot/07/set-property-zipcode.png b/docs/archived docs/media/tutorial-weatherbot/07/set-property-zipcode.png similarity index 100% rename from docs/media/tutorial-weatherbot/07/set-property-zipcode.png rename to docs/archived docs/media/tutorial-weatherbot/07/set-property-zipcode.png diff --git a/docs/media/tutorial-weatherbot/07/weather-intent-selection.png b/docs/archived docs/media/tutorial-weatherbot/07/weather-intent-selection.png similarity index 100% rename from docs/media/tutorial-weatherbot/07/weather-intent-selection.png rename to docs/archived docs/media/tutorial-weatherbot/07/weather-intent-selection.png diff --git a/docs/media/tutorial-weatherbot/07/with-entity-lookup.png b/docs/archived docs/media/tutorial-weatherbot/07/with-entity-lookup.png similarity index 100% rename from docs/media/tutorial-weatherbot/07/with-entity-lookup.png rename to docs/archived docs/media/tutorial-weatherbot/07/with-entity-lookup.png diff --git a/docs/media/tutorial-weatherbot/07/zipcode-regex-entity.png b/docs/archived docs/media/tutorial-weatherbot/07/zipcode-regex-entity.png similarity index 100% rename from docs/media/tutorial-weatherbot/07/zipcode-regex-entity.png rename to docs/archived docs/media/tutorial-weatherbot/07/zipcode-regex-entity.png diff --git a/docs/media/validation/expression-inline-error.png b/docs/archived docs/media/validation/expression-inline-error.png similarity index 100% rename from docs/media/validation/expression-inline-error.png rename to docs/archived docs/media/validation/expression-inline-error.png diff --git a/docs/media/validation/expression-missing-property.png b/docs/archived docs/media/validation/expression-missing-property.png similarity index 100% rename from docs/media/validation/expression-missing-property.png rename to docs/archived docs/media/validation/expression-missing-property.png diff --git a/docs/media/validation/hover-message-lg.png b/docs/archived docs/media/validation/hover-message-lg.png similarity index 100% rename from docs/media/validation/hover-message-lg.png rename to docs/archived docs/media/validation/hover-message-lg.png diff --git a/docs/media/validation/inline-error-lg.png b/docs/archived docs/media/validation/inline-error-lg.png similarity index 100% rename from docs/media/validation/inline-error-lg.png rename to docs/archived docs/media/validation/inline-error-lg.png diff --git a/docs/media/validation/lg-all-up-view.png b/docs/archived docs/media/validation/lg-all-up-view.png similarity index 100% rename from docs/media/validation/lg-all-up-view.png rename to docs/archived docs/media/validation/lg-all-up-view.png diff --git a/docs/media/validation/lu-all-up-view.png b/docs/archived docs/media/validation/lu-all-up-view.png similarity index 100% rename from docs/media/validation/lu-all-up-view.png rename to docs/archived docs/media/validation/lu-all-up-view.png diff --git a/docs/media/validation/lu-inline-error.png b/docs/archived docs/media/validation/lu-inline-error.png similarity index 100% rename from docs/media/validation/lu-inline-error.png rename to docs/archived docs/media/validation/lu-inline-error.png diff --git a/docs/media/validation/lu-popup.png b/docs/archived docs/media/validation/lu-popup.png similarity index 100% rename from docs/media/validation/lu-popup.png rename to docs/archived docs/media/validation/lu-popup.png diff --git a/docs/media/validation/notification-all-up-view.png b/docs/archived docs/media/validation/notification-all-up-view.png similarity index 100% rename from docs/media/validation/notification-all-up-view.png rename to docs/archived docs/media/validation/notification-all-up-view.png diff --git a/docs/media/validation/start-grey.png b/docs/archived docs/media/validation/start-grey.png similarity index 100% rename from docs/media/validation/start-grey.png rename to docs/archived docs/media/validation/start-grey.png diff --git a/docs/onboarding.md b/docs/archived docs/onboarding.md similarity index 100% rename from docs/onboarding.md rename to docs/archived docs/onboarding.md diff --git a/docs/quickstart-create-bot.md b/docs/archived docs/quickstart-create-bot.md similarity index 100% rename from docs/quickstart-create-bot.md rename to docs/archived docs/quickstart-create-bot.md diff --git a/docs/setup-yarn.md b/docs/archived docs/setup-yarn.md similarity index 100% rename from docs/setup-yarn.md rename to docs/archived docs/setup-yarn.md diff --git a/docs/archived docs/toc.md b/docs/archived docs/toc.md new file mode 100644 index 0000000000..ce4444042e --- /dev/null +++ b/docs/archived docs/toc.md @@ -0,0 +1,74 @@ +# Microsoft Bot Framework Composer + +### Overview + +- [Introduction to Bot Framework Composer](./docs/introduction.md) + +### Installation + +- [Set up Composer using Yarn](./docs/setup-yarn.md) + +### QuickStart + +- [Tour of Composer](./docs/onboarding.md) +- [Create your first bot](./docs/quickstart-create-bot.md) + +### Tutorials + +0. [Introduction](./docs/tutorial/tutorial-introduction.md) +1. [Create a bot](./docs/tutorial/tutorial-create-bot.md) +1. [Add a dialog](./docs/tutorial/tutorial-add-dialog.md) +1. [Get weather report](./docs/tutorial/tutorial-get-weather.md) +1. [Add help and cancel commands](./docs/tutorial/tutorial-add-help.md) +1. [Add Language Generation](./docs/tutorial/tutorial-lg.md) +1. [Use cards](./docs/tutorial/tutorial-cards.md) +1. [Add LUIS](./docs/tutorial/tutorial-luis.md) + +### Concepts + +- [Dialogs](./docs/concept-dialog.md) +- [Events and triggers](./docs/concept-events-and-triggers.md) +- [Conversation flow and memory](./docs/concept-memory.md) +- [Language generation](./docs/concept-language-generation.md) +- [Language understanding](./docs/concept-language-understanding.md) + +### How to + +#### Develop + +- [Send messages](./docs/how-to-send-messages.md) +- [Ask for user input](./docs/how-to-ask-for-user-input.md) +- [Manage conversation flow](./docs/how-to-control-conversation-flow.md) +- [Add LUIS to your bot](./docs/how-to-use-LUIS.md) +- [Add QnA to your bot](./docs/how-to-add-qna-to-bot.md) +- [Send cards](./docs/how-to-send-cards.md) +- [Define triggers and events](./docs/how-to-define-triggers.md) +- [Define advanced intents and entities](./docs/how-to-define-advanced-intents-entities.md) +- [Use OAuth](./docs/how-to-use-oauth.md) +- [Send an HTTP request](./docs/how-to-send-http-request.md) + +#### Test + +- [Test in Emulator](https://docs.microsoft.com/en-us/azure/bot-service/bot-service-debug-emulator?view=azure-bot-service-4.0&tabs=csharp) + +#### Debug + +- [Linting and validation](./docs/how-to-use-validation.md) + +#### Publish + +- [Publish your bot to Azure](/docs/how-to-publish-bot.md) + +### Resources + +- [Bot Framework Adaptive Dialog](https://github.com/microsoft/BotBuilder-Samples/tree/master/experimental/adaptive-dialog) +- [Language generation](https://github.com/microsoft/BotBuilder-Samples/tree/master/experimental/language-generation) +- [Common expression language](https://github.com/microsoft/BotBuilder-Samples/blob/master/experimental/common-expression-language) +- [.lu file format](https://aka.ms/lu-file-format) +- [.lg file format](https://aka.ms/lg-file-format) + +## Related projects + +- [Bot Framework](https://github.com/microsoft/botframework) +- [Bot Framework SDK](https://github.com/microsoft/botframework-sdk) +- [Bot Framework Emulator](https://github.com/microsoft/botframework-emulator) diff --git a/docs/tutorial/tutorial-add-dialog.md b/docs/archived docs/tutorial/tutorial-add-dialog.md similarity index 100% rename from docs/tutorial/tutorial-add-dialog.md rename to docs/archived docs/tutorial/tutorial-add-dialog.md diff --git a/docs/tutorial/tutorial-add-help.md b/docs/archived docs/tutorial/tutorial-add-help.md similarity index 100% rename from docs/tutorial/tutorial-add-help.md rename to docs/archived docs/tutorial/tutorial-add-help.md diff --git a/docs/tutorial/tutorial-cards.md b/docs/archived docs/tutorial/tutorial-cards.md similarity index 100% rename from docs/tutorial/tutorial-cards.md rename to docs/archived docs/tutorial/tutorial-cards.md diff --git a/docs/tutorial/tutorial-create-bot.md b/docs/archived docs/tutorial/tutorial-create-bot.md similarity index 100% rename from docs/tutorial/tutorial-create-bot.md rename to docs/archived docs/tutorial/tutorial-create-bot.md diff --git a/docs/tutorial/tutorial-get-weather.md b/docs/archived docs/tutorial/tutorial-get-weather.md similarity index 100% rename from docs/tutorial/tutorial-get-weather.md rename to docs/archived docs/tutorial/tutorial-get-weather.md diff --git a/docs/tutorial/tutorial-introduction.md b/docs/archived docs/tutorial/tutorial-introduction.md similarity index 100% rename from docs/tutorial/tutorial-introduction.md rename to docs/archived docs/tutorial/tutorial-introduction.md diff --git a/docs/tutorial/tutorial-lg.md b/docs/archived docs/tutorial/tutorial-lg.md similarity index 100% rename from docs/tutorial/tutorial-lg.md rename to docs/archived docs/tutorial/tutorial-lg.md diff --git a/docs/tutorial/tutorial-luis.md b/docs/archived docs/tutorial/tutorial-luis.md similarity index 100% rename from docs/tutorial/tutorial-luis.md rename to docs/archived docs/tutorial/tutorial-luis.md diff --git a/docs/toc.md b/docs/toc.md new file mode 100644 index 0000000000..3afb1a976c --- /dev/null +++ b/docs/toc.md @@ -0,0 +1,82 @@ +# Microsoft Bot Framework Composer + +### Overview + +- [Introduction to Bot Framework Composer](https://aka.ms/bf-composer-docs-introduction) + +### Installation + +- [Install Composer](https://aka.ms/bf-composer-docs-setup-yarn) + +### QuickStart + +- [Tour of Composer](https://aka.ms/bf-composer-docs-onboarding) +- [Create your first bot](https://aka.ms/bf-composer-docs-create-first-bot) + +### Tutorials + +1. [Introduction](https://aka.ms/bf-composer-docs-tutorial-introduction) +2. [Create a bot](https://aka.ms/bf-composer-docs-tutorial-create-bot) +3. [Add a dialog](https://aka.ms/bf-composer-docs-tutorial-add-dialog) +4. [Get weather report](https://aka.ms/bf-composer-docs-tutorial-get-weather-report) +5. [Add help and cancel commands](https://aka.ms/bf-composer-docs-tutorial-add-help-cancel-command) +6. [Add Language Generation](https://aka.ms/bf-composer-docs-tutorial-add-lg) +7. [Use cards](https://aka.ms/bf-composer-docs-tutorial-use-cards) +8. [Add LUIS](https://aka.ms/bf-composer-docs-tutorial-add-luis) + +### Concepts + +- [Dialogs](https://aka.ms/bf-composer-docs-dialog) +- [Events and triggers](https://aka.ms/bf-composer-docs-triggers) +- [Conversation flow and memory](https://aka.ms/bf-composer-docs-memory) +- [Concept natural language processing](https://aka.ms/bf-composer-docs-nlp) +- [Language generation](https://aka.ms/bf-composer-docs-lg) +- [Language understanding](https://aka.ms/bf-composer-docs-lu) + +### Samples + +- [Use samples](https://aka.ms/bf-composer-docs-use-samples) + +### How to + +#### Develop + +- [Send messages](https://aka.ms/bf-composer-docs-send-messages) +- [Send cards](https://aka.ms/bf-composer-docs-send-cards) +- [Ask for user input](https://aka.ms/bf-composer-docs-ask-input) +- [Manage conversation flow](https://aka.ms/bf-composer-docs-conversation-flow) +- [Add LUIS to your bot](https://aka.ms/bf-composer-docs-add-luis) +- [Add QnA to your bot](https://aka.ms/bf-composer-docs-add-qna) +- [Define triggers and events](https://aka.ms/bf-composer-docs-define-triggers) +- [Define advanced intents and entities](https://aka.ms/bf-composer-docs-define-intent-entity) +- [Use OAuth](https://aka.ms/bf-composer-docs-oauth) +- [Send an HTTP request](https://aka.ms/bf-composer-docs-http-request) +- [Connect to a skill](https://aka.ms/bf-composer-docs-connect-skill) +- [Add custom actions](https://aka.ms/bf-composer-docs-custom-action) + +#### Test + +- [Test in Emulator](https://docs.microsoft.com/en-us/azure/bot-service/bot-service-debug-emulator?view=azure-bot-service-4.0&tabs=csharp) + +#### Debug + +- [Linting and validation](https://aka.ms/bf-composer-docs-validation) + +#### Publish + +- [Publish your bot to Azure](https://aka.ms/bf-composer-docs-publish-bot) + +### Resources + +- [Bot Framework Adaptive Dialog](https://aka.ms/adaptive-dialogs) +- [Language generation](https://aka.ms/language-generation) +- [Adaptive expressions](https://aka.ms/adaptive-expressions) +- [.lu file format](https://aka.ms/lu-file-format) +- [.lg file format](https://aka.ms/lg-file-format) +- [Glossary concepts](https://aka.ms/bf-composer-docs-glossary-concepts) + +## Related projects + +- [Bot Framework](https://github.com/microsoft/botframework) +- [Bot Framework SDK](https://github.com/microsoft/botframework-sdk) +- [Bot Framework Emulator](https://github.com/microsoft/botframework-emulator)