Rename to Learn Validation

928PJY · web-flow · commit 94a3b05bff57 · 2022-09-26T17:00:04.000+08:00
diff --git a/README.md b/README.md
@@ -1,44 +1,46 @@
-# Docs Validation
+# Learn Validation
 
-This extension enables you to run build validation on a Docs conceptual or Learn repo at author time in VS Code. This means you can make sure your repo is free of validation issues before making a pull request.
+This extension enables you to run build validation on a Learn conceptual or reference repository at author time in VS Code. This means you can make sure your repo is free of validation issues before making a pull request.
 
-[!IMPORTANT]
-> The source codes of the repo have been moved into Azure DevOps to follow security and compliance requirements. We will revisit the open source strategy in the future and may open the repo as open source again. Stay tuned!
-> You are still welcomed to submit your issues or feature requests via [Issues](#issue).
+## Prerequisites
 
-## How to use the Docs Validation extension
+- Install [git](https://git-scm.com/downloads).
+- Clone your Learn repo locally in VS Code.
+- All files in the repo must be saved when you are using the manually triggered validation.
+
+## How to use the Learn Validation extension
 
 ### Manually triggered validation
 
-1. Open the root folder or any sub-folder of a Docs conceptual or Learn repo in VS Code with the extension installed.
+1. Open the root folder or any sub-folder of a Learn repository in VS Code with the extension installed.
 1. For the first time you use the extension, you will be asked to choose your user type between **Microsoft employee** and **Public contributor** before you can use full-repository validation.
-1. For **Microsoft employee**, you are required to sign in before using full-repository validation. You can click **Docs Validation** on the status bar then click **Sign in** from the drop-down menu to sign in.
+1. For **Microsoft employee**, you are required to sign in before using full-repository validation. You can click **Learn Validation** on the status bar then click **Sign in** from the drop-down menu to sign in.
 1. There are three ways to trigger the manual validation:
    1. After signing in, you can trigger a validation by clicking **Validate** when prompted. This will trigger the validation on the current opening workspace, so the files outside the current workspace will not be validated if you are on the sub-folder of a repository.
-   2. You can click **Docs Validation** on the status bar then click **Validate the current workspace** from the drop-down menu to trigger the validation on the current workspace.
+   2. You can click **Learn Validation** on the status bar then click **Validate the current workspace** from the drop-down menu to trigger the validation on the current workspace.
    3. You can right-click any file/folder inside the **Explorer** and select **Validate this folder**, if you click on the file, the validation will be applied to the folder contains the selected file, otherwise, the validation will be applied to the selected folder.
 1. Build validation will run locally and all results will be output to the Problems pane.
 
-![OAuth](./resources/vscode-docs-build.gif?raw=true)
+![OAuth](https://github.com/docascode/vscode-docs-build/blob/main/resources/vscode-docs-build.gif?raw=true)
 
-> **Note:** The first time you validate a repo, all the Docs build dependencies will be fetched and cached locally. Subsequent validation runs will be faster.
+> **Note:** The first time you validate a repo, all the Learn build dependencies will be fetched and cached locally. Subsequent validation runs will be faster.
 
 ### Real-time validation
 
-1. Open the root folder or any sub-folder of a Docs conceptual or Learn repo in VS Code with the extension installed.
+1. Open the root folder or any sub-folder of a or Learn repository in VS Code with the extension installed.
 2. For the first time you use the extension, you will be asked to choose your user type between **Microsoft employee** and **Public contributor** before you can use real-time validation.
-3. The real-time validation is enabled by default, you can disable it in the extension settings (Go to Settings -> Docs Validation -> Uncheck **Real-time Validation: Automatically Enable**). You will be asked to reload the extension after you disable real-time validation.
+3. The real-time validation is enabled by default, you can disable it in the extension settings (Go to Settings -> Learn Validation -> Uncheck **Real-time Validation: Automatically Enable**). You will be asked to reload the extension after you disable real-time validation.
 
-![OAuth](./resources/enable-real-time-validation.gif?raw=true)
+![OAuth](https://github.com/docascode/vscode-docs-build/blob/main/resources/enable-real-time-validation.gif?raw=true)
 
 4. For **Microsoft employee**, the extension will check your sign-in status before real-time validation starts to work. If you haven't signed in or your credential expired, you will be asked to sign in. After sign-in succeeds, real-time validation will start automatically.
 5. With real-time validation enabled, you will see validation issues (if any) while you are working on the repository (eg. modifying files, creating files and deleting files etc.).
 
-![OAuth](./resources/real-time-validation-exp.gif?raw=true)
+![OAuth](https://github.com/docascode/vscode-docs-build/blob/main/resources/real-time-validation-exp.gif?raw=true)
 
 ## Known issues
 
-### Inconsistent results between Docs Build validation and full-repository validation.
+### Inconsistent results between Learn Build validation and full-repository validation.
 
 - bookmark-not-found: The rendering information required to validate bookmarks in schema-based content isn't available publicly, so if you aren't signed in as a Microsoft employee you might not get all broken bookmark results.
 - author-not-found and ms-author-invalid: These validations require external API calls that aren't supported locally at this time, so no results will be returned for them.
@@ -52,13 +54,13 @@ Inconsistent results caused by the currently edited file needs validation result
 - publish-url-conflict
 - output-path-conflict
 - Content or Metadata uniqueness
-    - duplicate-uid
-    - xref-property-conflict
-    - moniker-overlapping
-    - duplicate-title
-    - altText-duplicate
-    - duplicate-h1
-    - ...
+  - duplicate-uid
+  - xref-property-conflict
+  - moniker-overlapping
+  - duplicate-title
+  - altText-duplicate
+  - duplicate-h1
+  - ...
 - bookmark-not-found
 - Validation on hierarchy (for example `unit-no-module-parent`)
 
@@ -71,6 +73,7 @@ Inconsistent results caused by the currently edited file affects other files' va
 - file-not-found
 
 Other situations:
+
 - Pull-request-only suggestions will be ignored by full-repository validation but will be reported by real-time validation.
 - Include files will not be validated before you open any file includes them.
 - .openpublishing.redirection.json will not be validated before you open any content file (.md or .yml).
@@ -87,7 +90,7 @@ When your validation fails with some error message like:
 
 ```bash
 fatal: unable to access 'https://github.com/Microsoft/templates.docs.msft/': The requested URL returned error: 403
-git-clone-failed Failure to clone the repository `https://github.com/Microsoft/templates.docs.msft#master`. This could be caused by an incorrect repository URL, please verify the URL on the Docs Portal (https://ops.microsoft.com). This could also be caused by not having the proper permission the repository, please confirm that the GitHub group/team that triggered the build has access to the repository.
+git-clone-failed Failure to clone the repository `https://github.com/Microsoft/templates.docs.msft#master`. This could be caused by an incorrect repository URL, please verify the URL on the Microsoft Learn Portal (https://ops.microsoft.com). This could also be caused by not having the proper permission the repository, please confirm that the GitHub group/team that triggered the build has access to the repository.
 Restore done in 11.77s
 
   1 Error(s), 0 Warning(s), 0 Suggestion(s)
@@ -114,13 +117,15 @@ Please try the following solutions:
    ```
 
 1. GitHub has recently enabled SSO on Microsoft-owned organizations. If you see the below errors, please follow the instructions there to enable SSO on your token so that local validation can pass through.
+
    ```bash
    fatal: unable to access 'https://github.com/Microsoft/templates.docs.msft/': The requested URL returned error: 403
    remote: The `microsoft' organization has enabled or enforced SAML SSO. To access
    remote: this repository, visit https://github.com/enterprises/microsoftopensource/sso?authorization_request=AEJANEWOPPW6YTNW5TYNW2K7OBDR3A5PN5ZGOYLONF5GC5DJN5XF62LEZYAF32PCVVRXEZLEMVXHI2LBNRPWSZGODVDHWBVPMNZGKZDFNZ2GSYLML52HS4DFVNHWC5LUNBAWGY3FONZQ
    ```
 
 1. If you see the below errors while cloning the template repository, this is caused by that you used the `Git Credential Manager Core` before GitHub enabled the SSO, and you need to re-authorize the application.
+
    ```bash
    $ git clone https://github.com/microsoft/templates.docs.msft.git
    Cloning into 'templates.docs.msft'...
@@ -130,39 +135,61 @@ Please try the following solutions:
    ```
 
    Please follow the steps below to re-authorize, you can either:
+
    - Sign in with your browser.
 
-      a. Go to [Github application setting page](https://github.com/settings/applications).
-      
-      b. Go inside `Git Credential Manager` and click `Revoke access`.
+     a. Go to [Github application setting page](https://github.com/settings/applications).
+
+     b. Go inside `Git Credential Manager` and click `Revoke access`.
 
-      c. Retry to clone the repository in commander/ terminal.
+     c. Retry to clone the repository in commander/ terminal.
+
+     d. Select `Sign in with your browser` in the pop-up window.
 
-      d. Select `Sign in with your browser` in the pop-up window.
    - Sign in with `Personal Access Token`.
 
-      a. Go to [Github token setting page](https://github.com/settings/tokens).
-         
-      b. Generate a new token if you don't have one. Enter the note of the token, check `repo` in `Select scopes` section, and click `Generate token`.
+     a. Go to [Github token setting page](https://github.com/settings/tokens).
 
-      c. Enable the SSO for the token used in `Git Credential Manager Core`.
+     b. Generate a new token if you don't have one. Enter the note of the token, check `repo` in `Select scopes` section, and click `Generate token`.
 
-      ![OAuth](./resources/enable-sso.png?raw=true)
+     c. Enable the SSO for the token used in `Git Credential Manager Core`.
 
-      d. Retry to clone the repository in commander/ terminal.
+     ![OAuth](https://github.com/docascode/vscode-docs-build/blob/main/resources/enable-sso.png?raw=true)
 
-      e. Enter `Personal Access Token` in the pop-up window.
+     d. Retry to clone the repository in commander/ terminal.
 
+     e. Enter `Personal Access Token` in the pop-up window.
 
 ## License
 
-[MIT](https://raw.githubusercontent.com/docascode/vscode-docs-build/master/LICENSE)
+[MIT](https://raw.githubusercontent.com/docascode/vscode-docs-build/main/LICENSE)
 
 ## Privacy statements
 
 For Microsoft employee: https://privacy.microsoft.com/en-US/data-privacy-notice  
 For Public contributor: https://privacy.microsoft.com/en-us/privacystatement
 
+## Key
+
 ## Issue
 
-[File a issue](./docs/file-issue.md)
+[File a issue](https://github.com/docascode/vscode-docs-build/blob/main/docs/file-issue.md)
+
+## How to Contribute
+
+[Contribution guideline](https://github.com/docascode/vscode-docs-build/blob/main/docs/contribution-guide.md)
+
+## Pipelines
+
+| Pipeline | Description | Trigger condition | Status |
+|--|--|--|--|
+| **vscode-docs-build-CodeCheck** | SDL related code check built on OneBranch | PR created to main branch <br /> `or` Code Merged into main branch | [![Build Status](https://ceapex.visualstudio.com/Engineering/_apis/build/status/OneBranch/vscode-docs-build/vscode-docs-build-CodeCheck?repoName=vscode-docs-build&branchName=main)](https://ceapex.visualstudio.com/Engineering/_build/latest?definitionId=4230&repoName=vscode-docs-build&branchName=main) |
+| **vscode-docs-build-CodeTest** | Run Test and collect the test coverage on two platforms: Windows and MacOS | PR created to main branch <br /> `or` Code Merged into main branch | [![Build Status](https://ceapex.visualstudio.com/Engineering/_apis/build/status/vscode-docs-build/vscode-docs-build-CodeTest?branchName=main)](https://ceapex.visualstudio.com/Engineering/_build/latest?definitionId=4350&branchName=main) |
+| **vscode-docs-build-LGTM** | LGTM related check | Code Merged into main branch | [![Build Status](https://ceapex.visualstudio.com/Engineering/_apis/build/status/vscode-docs-build/vscode-docs-build-LGTM?branchName=main)](https://ceapex.visualstudio.com/Engineering/_build/latest?definitionId=4327&branchName=main) |
+| **vscode-docs-build-Official** | Official release pipeline | Manual trigger | [![Build Status](https://ceapex.visualstudio.com/Engineering/_apis/build/status/OneBranch/vscode-docs-build/vscode-docs-build-Official?repoName=vscode-docs-build&branchName=main)](https://ceapex.visualstudio.com/Engineering/_build/latest?definitionId=4333&repoName=vscode-docs-build&branchName=main) |
+
+## Secrets management
+
+Please reference the document [Secrets managements](https://microsoft.sharepoint.com/teams/docsmicrosoftcom/_layouts/OneNote.aspx?id=%2Fteams%2Fdocsmicrosoftcom%2FShared%20Documents%2FOPS%20Build%2FOPS%20Build%20Channel%20OneNote&wd=target%28Docs%20Validation%20VSCode%20Extension.one%7C885B4924-63D4-4A36-9FF8-045844298BA0%2FSecrets%20managements%7C6BE16B1A-058E-486C-8563-6D340DEF0187%2F%29) for the detail
+
+**All contributions are welcome!**
