[](/docs/tutorials/csharp/skill.md) [](/docs/tutorials/typescript/skill.md)
|Creating a new Skill using the template| |4. Customize your Skill[](/docs/tutorials/csharp/customizeskill.md) [](/docs/tutorials/typescript/customizeassistant.md)
|Building your first skill| - # How-To > How-to guides for achieving more complex scenarios. @@ -42,14 +41,13 @@ | Name | Description | | ---- | ----------- | -| [How To: Enhance your Assistant with additional Skills](/docs/skills/common/addingskills.md) | Adding the out-of-the-box Skills to your Virtual Assistant | -| How To: Authenticate users in your Assistant[](/docs/advanced/assistant/csharp/addauthentication.md) [](/docs/advanced/assistant/typescript/addauthentication.md)
|How to add user authentication to your Assistant | -| [How To: Enable Linked Accounts](/docs/advanced/assistant/linkedaccounts.md) | Enable users to link third party accounts (e.g. Office 365) to your Assistant | -| How To: Migrate from the Enterprise Template[](/docs/advanced/assistant/csharp/ettovamigration.md)
| Guidance on how to move from an Enterprise Template based Bot to the new Template| -| How to: Migrate from the old Virtual Assistant solution[](/docs/advanced/assistant/csharp/oldvatovamigration.md)
|Guidance on how to move from the original Virtual Assistant solution to the new Template | -| [How To: Messaging your users proactively](/docs/advanced/assistant/csharp/proactivemessaging.md) | Adding proactive experiences to your assistant | -| [How To: Enable cross bot communication into one conversational experience](/docs/advanced/assistant/parentchildbotpattern.md) | Create one central Assistant which hands-off to child bots (a common enterprise scenario) | -| [How To: Customize Azure Resource Deployment](/docs/advanced/assistant/customizedeployment.md) | How to customise the provided ARM template for different deployment scenarios. | +| How To: Authenticate users in your Assistant[](/docs/howto/assistant/csharp/addauthentication.md) [](/docs/howto/assistant/typescript/addauthentication.md)
|How to add user authentication to your Assistant | +| [How To: Enable Linked Accounts](/docs/howto/assistant/linkedaccounts.md) | Enable users to link third party accounts (e.g. Office 365) to your Assistant | +| How To: Migrate from the Enterprise Template[](/docs/howto/assistant/csharp/ettovamigration.md)
| Guidance on how to move from an Enterprise Template based Bot to the new Template| +| How to: Migrate from the old Virtual Assistant solution[](/docs/howto/assistant/csharp/oldvatovamigration.md)
|Guidance on how to move from the original Virtual Assistant solution to the new Template | +| [How To: Messaging your users proactively](/docs/howto/assistant/csharp/proactivemessaging.md) | Adding proactive experiences to your assistant | +| [How To: Enable cross bot communication into one conversational experience](/docs/howto/assistant/parentchildbotpattern.md) | Create one central Assistant which hands-off to child bots (a common enterprise scenario) | +| [How To: Customize Azure Resource Deployment](/docs/howto/assistant/customizedeployment.md) | How to customise the provided ARM template for different deployment scenarios. | | How To: Secure your keys using Azure Key Vault :construction_worker_woman: | How to safeguard your keys using Azure Key Vault| @@ -57,10 +55,10 @@ | Name | Description | | ---- | ----------- | -| [How To: Add a new Skill to your Assistant](/docs/advanced/skills/addingskills.md) | Adding a Skill | -| How To: Add Skills to an existing SDK v4 bot[](/docs/advanced/skills/csharp/addskillsupportforv4bot.md) [](/docs/advanced/skills/typescript/addskillsupportforv4bot.md)
|How to add Skills to an existing bot (not Virtual Assistant template). | -|How To: Convert an existing v4 SDK Bot to a Skill[](/docs/advanced/skills/csharp/skillenablingav4bot.md) [](/docs/advanced/skills/typescript/skillenablingav4bot.md)
| Steps required to take an existing and make it available as a skill. | -| [How To: Develop a Skill](/docs/advanced/skills/bestpractices.md) | Design Best practices for Skills | +| [How To: Add a new Skill to your Assistant](/docs/howto/skills/addingskills.md) | Adding a Skill | +| How To: Add Skills to an existing SDK v4 bot[](/docs/howto/skills/csharp/addskillsupportforv4bot.md) [](/docs/howto/skills/typescript/addskillsupportforv4bot.md)
|How to add Skills to an existing bot (not Virtual Assistant template). | +|How To: Convert an existing v4 SDK Bot to a Skill[](/docs/howto/skills/csharp/skillenablingav4bot.md) [](/docs/howto/skills/typescript/skillenablingav4bot.md)
| Steps required to take an existing and make it available as a skill. | +| [How To: Develop a Skill](/docs/howto/skills/bestpractices.md) | Design Best practices for Skills | # Reference @@ -68,10 +66,10 @@ ## Virtual Assistant -|Name|Description| -|-------------|-----------| -|[Template Outline](/docs/advanced/assistant/templateoutline.md)|An outline of what the Virtual Assistant template provides| -|[Under the covers](/docs/advanced/assistant/underthecovers.md)|Detailed documentation covering what the template provides and how it works| +| Name | Description | +| ---- | ----------- | +|[Template Outline](/docs/reference/assistant/templateoutline.md)|An outline of what the Virtual Assistant template provides| +|[Under the covers](/docs/reference/assistant/underthecovers.md)|Detailed documentation covering what the template provides and how it works| |[Underlying architecture](/docs/reference/assistant/architecture.md)|Detailed exploration of the overall Virtual Assistant Architecture| |[Template structure](/docs/reference/assistant/projectstructure.md)|Walkthrough of your Virtual Assistant project| |[Generating bot responses](/docs/reference/assistant/responses.md)|Your Virtual Assistant can respond in a variety of ways depending on the scenario and the users active device or conversation canvas| @@ -81,29 +79,32 @@ ## Skills -|Name|Description| -|-------------|-----------| +| Name | Description | +| ---- | ----------- | |[Skills Architecture](/docs/reference/skills/architecture.md)|Under the covers of the Skill Implementation, SkillDialog, Adapter and Middleware| -|[Parent Bot to Skill Authentication](/docs/reference/skills/skillauthentication.md) |Principles, Flow| +|[Parent Bot to Skill Authentication](/docs/reference/skills/skillauthentication.md) |Principles, Flow| |[Skill Token Flow](/docs/reference/skills/skilltokenflow.md)|How a Skill can request a User authentication token| |[Skill Manifest](/docs/reference/skills/skillmanifest.md)| Overview of the Skill Manifest file and it's role with Skill registration and invocation| |[Skill CLI Tools](/docs/reference/skills/skillcli.md)| Detailed information on the Skill command line tool and the steps it performs on your behalf.| |[Adaptive Card Styling](/docs/reference/skills/adaptivecardstyling.md)|Adjusting the look and feel of an Assistant's cards to reflect your brand| -|[Calendar Skill](/docs/advanced/skills/productivity-calendar.md)|Add calendar capabilities to your assistant. Powered by Microsoft Graph and Google.| -|[Email Skill](/docs/advanced/skills/productivity-email.md)|Add email capabilities to your assistant. Powered by Microsoft Graph and Google.| -|[To-Do Skill](/docs/advanced/skills/productivity-todo.md)|Add task management capabilities to your assistant. Powered by Microsoft Graph.| -|[Point of Interest Skill](/docs/advanced/skills/productivity-pointofinterest.md)|Find points of interest and directions. Powered by Azure Maps and FourSquare.| -|[Automotive Skill](/docs/advanced/skills/automotive.md)|Industry-vertical Skill for showcasing enabling car feature control.| -|[Experimental Skills](/docs/advanced/skills/experimental.md)|News, Restaurant Booking and Weather.| +|[Calendar Skill](/docs/reference/skills/productivity-calendar.md)|Add calendar capabilities to your assistant. Powered by Microsoft Graph and Google.| +|[Email Skill](/docs/reference/skills/productivity-email.md)|Add email capabilities to your assistant. Powered by Microsoft Graph and Google.| +|[To Do Skill](/docs/reference/skills/productivity-todo.md)|Add task management capabilities to your assistant. Powered by Microsoft Graph.| +|[Point of Interest Skill](/docs/reference/skills/productivity-pointofinterest.md)|Find points of interest and directions. Powered by Azure Maps and FourSquare.| +|[Automotive Skill](/docs/reference/skills/automotive.md)|Industry-vertical Skill for showcasing enabling car feature control.| +|[Experimental Skills](/docs/reference/skills/experimental.md)|News, Restaurant Booking and Weather.| ## Analytics -|Name|Description| -|-------------|-----------| +| Name | Description | +| ---- | ----------- | |[Application Insights](/docs/reference/analytics/applicationinsights.md)|Detailed information on how Application Insights is used to collect information and powers our Analytics capabilities.| |[Power BI Template](/docs/reference/analytics/powerbi.md)|Detailed information on how the provided PowerBI template provides insights into your assistant usage.| |[Telemetry](/docs/reference/analytics/telemetrylogging.md)|How to configure telemetry collection for your assistant.| # Need Help? +Check out our [Known Issues](/docs/reference/knownissues.md) for common issues and resolutions. + +If you have any questions please start with [Stack Overflow](https://stackoverflow.com/questions/tagged/botframework) where we're happy to help. -If you have any questions please start with [Stack Overflow](https://stackoverflow.com/questions/tagged/botframework) where we're happy to help. Please use this GitHub Repos issue tracking capability to raise [issues](https://github.com/Microsoft/AI/issues/new?assignees=&labels=Type%3A+Bug&template=bug_report.md&title=) or [feature requests](https://github.com/Microsoft/AI/issues/new?assignees=&labels=Type%3A+Suggestion&template=feature_request.md&title=). +Use the GitHub Issues page to raise [issues](https://github.com/Microsoft/AI/issues/new?assignees=&labels=Type%3A+Bug&template=bug_report.md&title=) or [feature requests](https://github.com/Microsoft/AI/issues/new?assignees=&labels=Type%3A+Suggestion&template=feature_request.md&title=). diff --git a/docs/reference/assistant/templateoutline.md b/docs/reference/assistant/templateoutline.md new file mode 100644 index 0000000000..e69de29bb2 diff --git a/docs/advanced/assistant/underthecovers.md b/docs/reference/assistant/underthecovers.md similarity index 100% rename from docs/advanced/assistant/underthecovers.md rename to docs/reference/assistant/underthecovers.md diff --git a/docs/advanced/assistant/knownissues.md b/docs/reference/knownissues.md similarity index 100% rename from docs/advanced/assistant/knownissues.md rename to docs/reference/knownissues.md diff --git a/docs/advanced/skills/automotive.md b/docs/reference/skills/automotive.md similarity index 100% rename from docs/advanced/skills/automotive.md rename to docs/reference/skills/automotive.md diff --git a/docs/advanced/skills/experimental.md b/docs/reference/skills/experimental.md similarity index 100% rename from docs/advanced/skills/experimental.md rename to docs/reference/skills/experimental.md diff --git a/docs/advanced/skills/pointofinterest.md b/docs/reference/skills/pointofinterest.md similarity index 100% rename from docs/advanced/skills/pointofinterest.md rename to docs/reference/skills/pointofinterest.md diff --git a/docs/advanced/skills/productivity-calendar.md b/docs/reference/skills/productivity-calendar.md similarity index 100% rename from docs/advanced/skills/productivity-calendar.md rename to docs/reference/skills/productivity-calendar.md diff --git a/docs/advanced/skills/productivity-email.md b/docs/reference/skills/productivity-email.md similarity index 100% rename from docs/advanced/skills/productivity-email.md rename to docs/reference/skills/productivity-email.md diff --git a/docs/advanced/skills/productivity-todo.md b/docs/reference/skills/productivity-todo.md similarity index 100% rename from docs/advanced/skills/productivity-todo.md rename to docs/reference/skills/productivity-todo.md diff --git a/docs/tutorials/typescript/customizeskill.md b/docs/tutorials/typescript/customizeskill.md new file mode 100644 index 0000000000..e69de29bb2