Skip to content
This repository was archived by the owner on Nov 14, 2025. It is now read-only.

Wiki lab fixes #21

Merged
mkennten merged 9 commits into from
Feb 8, 2021
Merged

Wiki lab fixes #21

Changes from all commits
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
f1b7bcc
try githook
unaihuete93 Jan 19, 2021
a3617b7
clarify ellipsis
unaihuete93 Jan 19, 2021
106b0dc
confirm correct repo selected
unaihuete93 Jan 19, 2021
1886822
clarify repo and branch
unaihuete93 Jan 19, 2021
b634198
instruction missing
unaihuete93 Jan 19, 2021
e14f022
not needed if "close" not clicked , "Save" leaves the editor mode
unaihuete93 Jan 19, 2021
18b79c9
Revert "try githook"
unaihuete93 Jan 19, 2021
4028062
typos
unaihuete93 Jan 20, 2021
da17076
typo
unaihuete93 Jan 20, 2021
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 8 additions & 7 deletions Instructions/Labs/AZ400_M03_Sharing_Team_Knowledge_using_Azure_Project_Wikis.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -79,8 +79,8 @@ In this task, you will publish a branch of an Azure DevOps repo as wiki.
> **Note**: If your published wiki corresponds to a product version, you can publish new branches as you release new versions of your product.

1. On you lab computer, in the Azure DevOps portal displaying the **Sharing Team Knowledge using Azure Project Wikis** project, in the vertical menu on the left side, in the **Overview** section, click **Wiki** and review the existing content.
1. In the vertical menu on the left side, click **Repos**, in the upper section of the **Files** pane, in the dropdown list, select **main**, and review the content of the main branch.
1. To the left of the **Files** pane, in the listing of the repo folder and file hierarchy, expand the **Documents** folder and its **Images** subfolder, in the **Images** subfolder, locate the **Website.png** entry, hover with the mouse pointer over its right end to reveal the vertical ellipsis symbol representing the **More** menu, click **More**, and, in the dropdown menu, click **Download** to download the **Website.png** file to the local **Downloads** folder on your lab computer.
1. In the vertical menu on the left side, click **Repos**, in the upper section of the **Files** pane, make sure you have the **TailwindTraders-Website** repo selected (choose it from the dropdown on the top with Git icon). In the branch dropdown list (on top of "Files" with the branch icon), select **main**, and review the content of the main branch.
1. To the left of the **Files** pane, in the listing of the repo folder and file hierarchy, expand the **Documents** folder and its **Images** subfolder, in the **Images** subfolder, locate the **Website.png** entry, hover with the mouse pointer over its right end to reveal the vertical ellipsis (three dots) symbol representing the **More** menu, click **More**, and, in the dropdown menu, click **Download** to download the **Website.png** file to the local **Downloads** folder on your lab computer.

>**Note**: You will use this image in the next exercise of this lab.

Expand All @@ -103,7 +103,7 @@ In this task, you will publish a branch of an Azure DevOps repo as wiki.

In this task, you will manage content of the wiki you published in the previous task.

1. In the vertical menu on the left side, click **Repos**, ensure that the dropdown menu in the upper section of the **Files** pane displays the **main** entry, in the repo folder hierarchy, select the **Documents** folder, in the upper right corner, click **+ New** and, in the dropdown menu, click **File**.
1. In the vertical menu on the left side, click **Repos**, ensure that the dropdown menu in the upper section of the **Files** pane displays the **TailwindTraders-Website** repo and **main** branch, in the repo folder hierarchy, select the **Documents** folder, in the upper right corner, click **+ New** and, in the dropdown menu, click **File**.
1. In the **New file** panel, in the **New file name**, after the **/Documents/** prefix, type **.order**, and click **Create**.
1. On the **Contents** tab of the **.order** pane, type the following and click **Commit**.

Expand All @@ -118,7 +118,7 @@ In this task, you will manage content of the wiki you published in the previous

>**Note**: The order of wiki content should match the sequence of files and folders listed in the **.order** file.

1. In the vertical menu on the left side, click **Repos**, ensure that the dropdown menu in the upper section of the **Files** pane displays the **main** entry, in the listing of files, select **GitHubActions.md**, and on the **GitHubActions.md** pane, click **Edit**.
1. In the vertical menu on the left side, click **Repos**, ensure that the dropdown menu in the upper section of the **Files** pane displays the **TailwindTraders-Website** repo and **main** branch, in the listing of files, under **Documents**, select **GitHubActions.md**, and on the **GitHubActions.md** pane, click **Edit**.
1. On the **GitHubActions.md** pane, directly below the `#GitHub Actions` header, add the following markdown element referencing one of the images within the **Documents** folder:

```
Expand All @@ -139,13 +139,15 @@ In this exercise, you will step through creating and managing a project wiki.

In this task, you will create a project wiki and add to it a Mermaid diagram and an image.

1. On you lab computer, in the Azure DevOps portal displaying the Wiki pane of the **Sharing Team Knowledge using Azure Project Wikis** project, with the content of the **Tailwind Traders (Documents)** wiki selected, at the top of the pane, click the **Tailwind Traders (Documents)** dropdown list header, and, in the drop down list, select **Create new project wiki**.
1. On your lab computer, in the Azure DevOps portal displaying the Wiki pane of the **Sharing Team Knowledge using Azure Project Wikis** project, with the content of the **Tailwind Traders (Documents)** wiki selected, at the top of the pane, click the **Tailwind Traders (Documents)** dropdown list header, and, in the drop down list, select **Create new project wiki**.
1. In the **Page title** text box, type **Project Design**.
1. Place the cursor in the body of the page, click the left-most icon in the toolbar representing the header setting and, in the dropdown list, click **Header 1**. This will automatically add the hash character (**#**) at the beginning of the line.
1. Directly after the newly added **#** character, type **Authentication and Authorization** and press the **Enter** key.
1. Click the left-most icon in the toolbar representing the header setting and, in the dropdown list, click **Header 2**. This will automatically add the hash character (**##**) at the beginning of the line.
1. Directly after the newly added **##** character, type **Azure DevOps OAuth 2.0 Authorization Flow** and press the **Enter** key.

1. **Copy and paste** the following code to insert a mermaid diagram on your wiki.

```
::: mermaid
sequenceDiagram
Expand Down Expand Up @@ -173,7 +175,6 @@ In this task, you will create a project wiki and add to it a Mermaid diagram and

1. In the upper right corner of the editor pane, click the down-facing caret next to the **Save** button and, in the dropdown menu, click **Save with revision message**.
1. In the **Save page** dialog box, type **Authentication and authorization section with the OAuth 2.0 Mermaid diagram** and click **Save**.
1. On the **Project Design** pane, in the upper right corner, click **Edit**.
1. On the **Project Design** editor pane, place the cursor at the end of the Mermaid element you added earlier in this task, press the **Enter** key to add an extra line, click the left-most icon in the toolbar representing the header setting and, in the dropdown list, click **Header 2**. This will automatically add the double hash character (**##**) at the beginning of the line.
1. Directly after the newly added **##** character, type **User Interface** and press the **Enter** key.
1. On the **Project Design** editor pane, in the toolbar, click the paper clip icon representing the **Insert a file** action, in the **Open** dialog box, navigate to the **Downloads** folder, select the **Website.png** file you downloaded in the previous exercise, and click **Open**.
Expand All @@ -188,7 +189,7 @@ In this task, you will manage the newly created project wiki.

>**Note**: You will start by reverting the most recent change to the wiki page.

1. On you lab computer, in the Azure DevOps portal displaying the Wiki pane of the **Sharing Team Knowledge using Azure Project Wikis** project, with the content of the **Project Design** wiki selected, in the upper right corner, click the vertical ellipsis symbol and, in the dropdown menu, click view revisions.
1. On you lab computer, in the Azure DevOps portal displaying the Wiki pane of the **Sharing Team Knowledge using Azure Project Wikis** project, with the content of the **Project Design** wiki selected, in the upper right corner, click the vertical ellipsis symbol and, in the dropdown menu, click **View revisions**.
1. On the **Revisions** pane, click the entry representing the most recent change.
1. On the resulting pane, review the comparison between the previous and the current version of the document, click **Revert**, when prompted for the confirmation, click **Revert** again, and then click **Browse Page**.
1. Back on the **Project Design** pane, verify that the change was successfully reverted.
Expand Down