Skip to content
This repository was archived by the owner on Jun 30, 2022. It is now read-only.

Commit f4cd295

Browse files
authored
Update docs with table of contents, styling, CI/CD tutorials (#2691)
* Update primer/css to 13.2.0 * Add liquid toc.html file to add right table of contents on pages * Fix sidebar styling * Fix style * Fix style * clean up container styling * Fixed broken botskills cli reference * Fix link to sample skills * Add note to use az login before creating resources * Move event skill to archive to account for broken API until it's restored and removed refs in other docs. Fix nav so that language directories render below individual pages (skills/samples) * Fix the id naming between nav (left) and toc (right) Cleaned up styling with removing borders, adding backgrounds, font sizes, etc. * Updated styling and fix broken links to tutorials * Clean up template overview * Update responsiveness to appropriately scale between mobile and desktop views Add github mark icon to link to repository instead of text Clean up navbar * Add C#/Typescript tutorials for enabling continous integration based off of YAML docs * Move DevOps content to Enable continuous deployment tutorial
1 parent 28d7941 commit f4cd295

File tree

418 files changed

+6413
-1937
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

418 files changed

+6413
-1937
lines changed

docs/_data/toc.yml

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,8 +15,10 @@ Skills:
1515
Solution Accelerators:
1616
- Assistants
1717
- Samples
18+
- Enable continuous integration
19+
- Enable continuous deployment
1820
- Enable proactive notifications
19-
- View analytics using Power BI
21+
- View analytics with Power BI
2022
Clients and Channels:
2123
- Clients
2224
- Channels

docs/_docs/skills/samples/event.md renamed to docs/_docs/archive/event.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
category: Skills
2+
category: Archive
33
subcategory: Samples
44
language: Experimental Skills
55
title: Event Skill

docs/_docs/overview/virtual-assistant-solution.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -96,7 +96,7 @@ Sample client applications are implementations of clients that will integrate se
9696
{:.toc}
9797

9898
<div class="card-deck">
99-
<a href="{{site.baseurl}}/virtual-assistant/tutorials/csharp/create-assistant/1-intro" class="card">
99+
<a href="{{site.baseurl}}/virtual-assistant/tutorials/create-assistant/csharp/1-intro" class="card">
100100
<div class="card-body">
101101
<img src="{{site.baseurl}}/assets/images/icons/csharp.png" alt="C# icon" width="48px">
102102
<h4 class="card-title no_toc">Create a Virtual Assistant</h4>
@@ -106,7 +106,7 @@ Sample client applications are implementations of clients that will integrate se
106106
<div class="btn btn-primary">Get started</div>
107107
</div>
108108
</a>
109-
<a href="{{site.baseurl}}/virtual-assistant/tutorials/typescript/create-assistant/1-intro" class="card">
109+
<a href="{{site.baseurl}}/virtual-assistant/tutorials/create-assistant/typescript/1-intro" class="card">
110110
<div class="card-body">
111111
<img src="{{site.baseurl}}/assets/images/icons/typescript.png" alt="TypeScript icon" width="48px">
112112
<h4 class="card-title no_toc">Create a Virtual Assistant</h4>

docs/_docs/overview/virtual-assistant-template.md

Lines changed: 134 additions & 122 deletions
Large diffs are not rendered by default.

docs/_docs/overview/whats-new.md

Lines changed: 0 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,6 @@ At it's core is the [Virtual Assistant]({{site.baseurl}}/overview/virtual-assist
1717
For more details on Virtual Assistant review [What is the Virtual Assistant Solution?]({{site.baseurl}}/overview/virtual-assistant-solution).
1818

1919
## Virtual Assistant components
20-
{:.no_toc}
2120

2221
There are four major components within the Virtual Assistant:
2322

@@ -80,11 +79,6 @@ Microsoft has also improved the conversations in many of the existing skills tha
8079

8180
Microsoft has released a new experimental skill focused on Hospitality scenarios allowing for experiences such as managing reservations, check out, and amenity requests. You can find more details on scenarios that this supports in the [Hospitality Skill documentation]({{site.baseurl}}/skills/samples/hospitality).
8281

83-
#### Event Skill (Experimental)
84-
{:.no_toc}
85-
86-
Microsoft has released a new experimental skill focused on finding events from the popular platform [Eventbrite](http://www.eventbrite.com/). More details on scenarios that this supports can be found in the [Event Skill documentation]({{site.baseurl}}/skills/samples/event/).
87-
8882
#### IT Service Management (ITSM) Skill (Experimental)
8983
{:.no_toc}
9084

docs/_docs/skills/handbook/add-skills-to-a-virtual-assistant.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -52,7 +52,7 @@ The `--luisFolder` parameter can be used to point the Skill CLI at the source LU
5252
botskills connect --botName YOUR_BOT_NAME --remoteManifest "http://<YOUR_SKILL_MANIFEST>.azurewebsites.net/api/skill/manifest" --luisFolder [path] --cs
5353
```
5454

55-
See the [Skill CLI documentation]({{site.baseurl}}/reference/skills/botskills) for detailed CLI documentation.
55+
See the [Skill CLI documentation]({{site.baseurl}}/help/reference/botskills) for detailed CLI documentation.
5656

5757
## Manual Authentication Connection configuration
5858

@@ -82,7 +82,7 @@ botskills:
8282
botskills disconnect --skillId SKILL_ID
8383
```
8484

85-
> Note: The id of the Skill can also be aquired using the `botskills list` command. You can check the [Skill CLI documentation]({{site.baseurl}}/reference/skills/botskills) on this command.
85+
> Note: The id of the Skill can also be aquired using the `botskills list` command. You can check the [Skill CLI documentation]({{site.baseurl}}/help/reference/botskills) on this command.
8686

8787
## Updating an existing Skill to reflect changes to Actions or LUIS model
8888

docs/_docs/skills/samples/experimental.md

Lines changed: 0 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -290,24 +290,6 @@ This skill has a very limited LUIS model (available in English, French, Italian,
290290
"BingAnswerSearchKey": "{YOUR_PROJECT_ANSWER_SEARCH_KEY}"
291291
```
292292

293-
### Event Skill
294-
295-
The [Event Skill]({{site.repo}}/tree/master/skills/src/csharp/experimental/eventskill) provides a simple skill that integrates with [Eventbrite](https://www.eventbrite.com/platform/) to show information about events happening in the specified area.
296-
297-
This skill currently supports one scenario to get local event information.
298-
299-
![Event Example]({{site.baseurl}}/assets/images/skills-event-transcript.png)
300-
301-
#### Configuration
302-
{:.no_toc}
303-
304-
1. Get your own [Eventbrite API Key](https://www.eventbrite.com/platform/api-keys).
305-
1. Provide this value in your `appsettings.json` file.
306-
307-
```
308-
"eventbriteKey": "YOUR_EVENTBRITE_API_KEY"
309-
```
310-
311293
### Hospitality Skill
312294

313295
The [Hospitality Skill]({{site.repo}}/tree/master/skills/src/csharp/experimental/hospitalityskill) demonstrates experiences that would be useful in a hospitality specific scenario, such as being able to check out of a hotel, ordering room service, and requesting hotel amenities. This skill does not integrate a hotel service at this time, and is instead simulated with static data for testing purposes.

docs/_docs/skills/tutorials/add-prebuilt-skill/1-intro.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,4 +24,4 @@ Install Bot Framework development prerequisites and add one of the Skills provid
2424

2525
### Scenario
2626

27-
Add one of the sample skills provided in the [Bot Framework Solutions GitHub repository]({{site.repo}}/skills/csharp) provide to your Virtual Assistant. The Skills are only available in C# at this time but these can be added to a Typescript based assistant.
27+
Add any of the [sample Skills provided in the Bot Framework Solutions repository]({{site.repo}}/tree/next/skills/csharp) to your Virtual Assistant. The Skills are only available in C# at this time but these can be added to a Typescript based assistant.

docs/_docs/solution-accelerators/assistants/hospitality-assistant.md

Lines changed: 0 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -34,12 +34,6 @@ The majority of the skills connected to this sample are [experimental skills]({{
3434
- *Tell me about the jurassic park movie*
3535
- *Who is Bill Gates?*
3636

37-
#### [Event Skill]({{site.baseurl}}/skills/samples/event)
38-
{:.no_toc}
39-
##### Find local events
40-
{:.no_toc}
41-
- *What's happening nearby?*
42-
4337
#### [Hospitality Skill]({{site.baseurl}}/skills/samples/hospitality)
4438
{:.no_toc}
4539
##### Guest reservation changes
@@ -85,7 +79,6 @@ To configure this sample follow the steps below:
8579
1. Follow the [Create your Virtual Assistant tutorial]({{site.baseurl}}/virtual-assistant/tutorials/create-assistant/csharp/1-intro/) to deploy your assistant. Use the sample project you cloned instead of the Virtual Assistant template to include the hospitality customizations in this project.
8680
1. Clone the following skills from our repository:
8781
- [Hospitality Skill]({{site.repo}}/tree/next/skills/csharp/experimental/hospitalityskill)
88-
- [Event Skill]({{site.repo}}/tree/next/skills//csharp/experimental/eventskill)
8982
- [Point of Interest Skill]({{site.repo}}/tree/next/skills/csharp/pointofinterestskill)
9083
- [Weather Skill]({{site.repo}}/tree/next/skills/csharp/experimental/weatherskill)
9184
- [Bing Search Skill]({{site.repo}}/tree/next/skills/csharp/experimental/bingsearchskill)
Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
---
2+
layout: tutorial
3+
category: Solution Accelerators
4+
subcategory: Enable continuous deployment
5+
title: Intro
6+
order: 1
7+
---
8+
9+
# Tutorial: {{page.subcategory}}
10+
11+
## {{ page.title }}
12+
{:.no_toc}
13+
14+
### Purpose
15+
To run a release pipeline, you must generate an artifact based on a recent build. But what is an artifact? IT's a compressed version of the project or solution which contains all of the necessary information to create the base of a release pipeline configuration.
16+
17+
### Prerequisites
18+
- Enable continuous integration by creating a build pipeline with either:
19+
- [C# resources]({{site.baseurl}}/solution-accelerators/tutorials/enable-continuous-integration/csharp/1-intro/)
20+
- [Typescript resources]({{site.baseurl}}/solution-accelerators/tutorials/enable-continuous-integration/typescript/1-intro/)
21+
22+
### Time To Complete
23+
15 minutes
24+
25+
### Scenario
26+
A personalized release pipeline in **Azure DevOps**. This tutorial is based on a sample Virtual Assistant in the [Bot Framework Solutions repository]({{site.repo}}).

0 commit comments

Comments
 (0)