finishing up

seqdan · Aug 31, 2021 · 255d819 · 255d819
1 parent 99f6b54
commit 255d819
Show file tree

Hide file tree

Showing 6 changed files with 80 additions and 37 deletions.
diff --git a/docs/cross-service/cross-service-overview.md b/docs/cross-service/cross-service-overview.md
@@ -18,11 +18,11 @@ ms.date: 08/31/2021
 
 One of the major strengths of Azure DevOps is the integration it supports across its core services. Azure DevOps supports multiple integration points across each of the major services&mdash;Azure Boards, Azure Repos, Azure Pipelines, and Azure Test Plans. 
 
-Review this article to understand the various integration points across Azure DevOps. 
+Review this article to understand how to use various features to support collaboration and traceability for all your devops tasks. 
 
 
 
-## Collaboration across Azure Devops 
+## Collaboration across Azure DevOps 
 
 Collaborating within and across teams is supported with many of the features summarized in the following table. 
 
@@ -365,9 +365,42 @@ The following table summarizes the integration features between Azure Repos and
    :::column-end:::
 :::row-end:::
 --- 
-
-
-::: moniker-end
+:::row:::
+   :::column span="1":::
+      Code coverage
+   :::column-end::: 
+   :::column span="2":::
+      Publish and review code coverage results that indicate the proportion of your project's code that is actually being tested. To learn more, see [Publish Code Coverage Results task](../pipelines/tasks/test/publish-code-coverage-results.md) and [Review code coverage results](../pipelines/test/review-code-coverage-results.md). 
+   :::column-end:::
+:::row-end:::
+--- 
+:::row:::
+   :::column span="1":::
+      View test results in builds and releases
+   :::column-end::: 
+   :::column span="2":::
+      Measure pipeline quality, review traceability, and troubleshoot failures by surfacing test reulst in pipeline builds and releases. To learn more, see [Review test results](../pipelines/test/review-continuous-test-results-after-build.md). 
+   :::column-end:::
+:::row-end:::
+--- 
+:::row:::
+   :::column span="1":::
+      Run automated tests in build pipelines
+   :::column-end::: 
+   :::column span="2":::
+      Associate test plans with a build pipeline so that they run with each build. To learn more, see [Run automated tests from test plans](..//test/run-automated-tests-from-test-hub.md). 
+   :::column-end:::
+:::row-end:::
+--- 
+:::row:::
+   :::column span="1":::
+      Run automated tests in build pipelines
+   :::column-end::: 
+   :::column span="2":::
+      Associate test plans with a build pipeline so that they run with each build. To learn more, see [Run automated tests from test plans](..//test/run-automated-tests-from-test-hub.md). 
+   :::column-end:::
+:::row-end:::
+--- 
 
 
 
@@ -481,7 +514,6 @@ Several collaboration scenarios are supported through Azure Boards work item typ
    :::column span="3":::
       Defines steps used to validate individual parts of your code to ensure your code works correctly, has no errors, and meets business and customer requirements. You can add individual test cases to a test plan without creating a test suite. More than one test suite or test plan can refer to a test case. You can effectively reuse test cases without having to copy or clone them for each suite or plan. To learn more, see [Create manual test cases](../test/create-test-cases.md).
    :::column-end:::
-   :::column-end:::
 :::row-end:::
 ---
 :::row:::
@@ -509,7 +541,7 @@ Several collaboration scenarios are supported through Azure Boards work item typ
 :::row-end:::
 ---
 
-## Test work item types
+### Test work item types
 
 Work item types that support the test experience are linked together using the link types shown in the following image. These include *Tested By/Tests*, *Test Cases/Shared Steps*, and *Reference By/References*. 
 
@@ -518,7 +550,7 @@ Work item types that support the test experience are linked together using the l
 From the web portal, you can view which test cases are defined for a test suite, and which test suites are defined for a test plan. However, these objects aren't connected to each other through specific link types. 
 
 
-## Bug tracking 
+### Bug tracking 
 
 When tracking bugs using the Bug work item type, note the following supported integrations. 
 
@@ -527,9 +559,6 @@ When tracking bugs using the Bug work item type, note the following supported in
    :::column span="1":::
       **Scenario**
    :::column-end::: 
-   :::column span="1":::
-      **Work item type**
-   :::column-end:::
    :::column span="3":::
       **Description**
    :::column-end:::
@@ -540,7 +569,7 @@ When tracking bugs using the Bug work item type, note the following supported in
       Create a bug from a testing tool
    :::column-end::: 
    :::column span="3":::
-      You can add a bug from Test Runner or the Test & Feedback extension. To learn more, see [../boards/backlogs/manage-bugs.md#create-a-bug-from-a-testing-tool].
+      You can add a bug from Test Runner or the Test & Feedback extension. To learn more, see [Define, capture, triage, and manage bugs](../boards/backlogs/manage-bugs.md#create-a-bug-from-a-testing-tool).
    :::column-end:::
 :::row-end:::
 ---
@@ -745,6 +774,8 @@ Widgets are annotated as follows:
 ---
 
 
+::: moniker range=">= azure-devops-2019" 
+
 ## Data available from Analytics
 
 Analytics provides the reporting platform for Azure DevOps. Analytics is generally available for Azure DevOps Service and Azure DevOps Server 2020. It is in preview for Azure DevOps Server 2019. 
@@ -754,9 +785,11 @@ Analytics provides the reporting platform for Azure DevOps. Analytics is general
 ---
 :::row:::
    :::column span="1":::
+
       **Service**
    :::column-end:::
-   :::column span="2":::
+   :::column span="1":::
+
       **Data availability**
    :::column-end:::
    :::column span="1":::
@@ -772,7 +805,7 @@ Analytics provides the reporting platform for Azure DevOps. Analytics is general
    :::column span="1":::
        **Boards** 
    :::column-end:::
-   :::column span="2":::
+   :::column span="1":::
       [Widgets](../report/dashboards/analytics-widgets.md)  
       [In-context reports](../report/dashboards/overview.md#in-context-reports-work-tracking)  
       [OData](../report/extend-analytics/quick-ref.md)
@@ -796,7 +829,7 @@ Analytics provides the reporting platform for Azure DevOps. Analytics is general
    :::column span="1":::
       **Repos** 
    :::column-end:::
-   :::column span="2":::
+   :::column span="1":::
       None
    :::column-end:::
    :::column span="1":::
@@ -832,7 +865,7 @@ Analytics provides the reporting platform for Azure DevOps. Analytics is general
    :::column span="1":::
       **Test Plans**
    :::column-end:::
-   :::column span="2":::
+   :::column span="1":::
       [Progress Report](../test/track-test-status.md)
    :::column-end:::
    :::column span="1":::
@@ -845,7 +878,7 @@ Analytics provides the reporting platform for Azure DevOps. Analytics is general
 ---
 :::row:::
    :::column span="1":::
-      Artifacts 
+      **Artifacts** 
    :::column-end:::
    :::column span="2":::
       None
@@ -859,6 +892,10 @@ Analytics provides the reporting platform for Azure DevOps. Analytics is general
 :::row-end:::
 ---
 
+
+::: moniker-end 
+
+
 
 ## Related articles
 

diff --git a/docs/cross-service/github-integration.md b/docs/cross-service/github-integration.md
@@ -18,9 +18,8 @@ ms.date: 08/31/2021
 
 Azure Boards and Azure Pipelines provide several integration points with GitHub and GitHub Enterprise. 
 
-
 
-### Sign-in with GitHub credentials 
+## Sign-in with GitHub credentials 
 
 Azure DevOps simplifies deployment from your repository with seamless access to the Azure portal and Azure DevOps using your GitHub account credentials.
 
@@ -35,7 +34,6 @@ Azure DevOps simplifies deployment from your repository with seamless access to
    :::column-end:::
 :::row-end:::
 ---
-::: moniker-end
 ::: moniker range=">= azure-devops-2020"
 :::row:::
    :::column span="1":::
@@ -67,9 +65,8 @@ Azure DevOps simplifies deployment from your repository with seamless access to
    :::column-end:::
 :::row-end:::
 
-
 
-### Azure Boards and GitHub integration
+## Azure Boards and GitHub integration
 
 By connecting Azure Boards with GitHub repositories, you enable linking between GitHub commits, pull requests, and issues to work items. You can use GitHub for software development while using Azure Boards to plan and track your work. To get started, see [Azure Boards-GitHub integration](../boards/github/index.md).
 
@@ -143,9 +140,8 @@ By connecting Azure Boards with GitHub repositories, you enable linking between
 :::row-end:::
 ---
 
-
 
-### Azure Pipelines and GitHub integration
+## Azure Pipelines and GitHub integration
 
 You can use Azure Pipelines to automatically build, test, package, release, and deploy your GitHub repository code. To get started, see [Build GitHub repositories](../pipelines/repos/github.md). 
 
@@ -328,7 +324,7 @@ You can map your GitHub repositories to one or more projects in Azure DevOps.
 ::: moniker range="azure-devops"
 :::row:::
    :::column span="1":::
-      Github packages support in YAML pipelines
+      GitHub packages support in YAML pipelines
    :::column-end::: 
    :::column span="2":::
       In your YAML pipeline, specify a package type (NuGet or npm) that you want to consume from GitHub. For details, see [Resources: packages](../pipelines/process/resources.md). 
@@ -346,8 +342,9 @@ You can map your GitHub repositories to one or more projects in Azure DevOps.
       - **GitHub Checks** allows for sending detailed information about the pipeline status, test, code coverage, and errors. Status is posted to GitHub Checks for each job in the pipeline. 
       - **Status badges**: Supports adding Markdown syntax to a GitHub repo README.md file to display the pipeline status.  
       - GitHub artifacts show associated commits deployed in a release. To enhance traceability, you can see all the commits that were deployed to an environment for GitHub repositories, as a part of a specific release.  
-      - Track GitHub commits and associated issues in releases. Lists commits made in GitHub repos and the associated GitHub issues that are being deployed with a release. For details, see [Track GitHub commits and associated issues in releases (Release Notes)](/azure/devops/release-notes/2018/sep-10-azure-devops-launch#new-build-status-badge-url). 
-      For details, see:
+      - Track GitHub commits and associated issues in releases. Lists commits made in GitHub repos and the associated GitHub issues that are being deployed with a release. For details, see [Track GitHub commits and associated issues in releases (Release Notes)](/azure/devops/release-notes/2018/sep-10-azure-devops-launch#new-build-status-badge-url).  
+
+      For details, see:  
       - [Create your first pipeline, Add a status badge to your repository](../pipelines/create-first-pipeline.md#add-a-status-badge-to-your-repository).  
       - [GitHub Checks API](https://docs.github.com/en/rest/reference/checks)
       - [Display status for each pipeline job in GitHub Checks (Release Notes)](/azure/devops/release-notes/2019/sprint-146-update#automatic-github-service-connections-in-pipelines).   
@@ -358,5 +355,6 @@ You can map your GitHub repositories to one or more projects in Azure DevOps.
 
 ## Related articles
 
-- [Azure Boards-GitHub integration](../boards/github/index.md)
-- [Build GitHub repositories](../pipelines/repos/github.md) 
+- [Azure Boards-GitHub integration](../boards/github/index.md)  
+- [Build GitHub repositories](../pipelines/repos/github.md)  
+- [Git experience in Visual Studio](/visualstudio/version-control/git-with-visual-studio)
diff --git a/docs/cross-service/media/overview/concept-link-types-pipelines.png b/docs/cross-service/media/overview/concept-link-types-pipelines.png
diff --git a/docs/cross-service/media/overview/concept-link-types-repos.png b/docs/cross-service/media/overview/concept-link-types-repos.png
diff --git a/docs/get-started/toc.yml b/docs/get-started/toc.yml
@@ -2,6 +2,14 @@
   href: index.yml
 - name: Start using Azure DevOps
   href: ../user-guide/toc.yml
+- name: Integration overview
+  items:
+  - name: Cross-service integration overview
+    href: ../cross-service/cross-service-overview.md?toc=/azure/devops/get-started/toc.json&bc=/azure/devops/get-started/breadcrumb/toc.json    
+  - name: GitHub integration 
+    href: ../cross-service/github-integration.md?toc=/azure/devops/get-started/toc.json&bc=/azure/devops/get-started/breadcrumb/toc.json    
+  - name: Deploy to Azure
+    href: ../pipelines/overview-azure.md?toc=/azure/devops/get-started/toc.json&bc=/azure/devops/get-started/breadcrumb/toc.json    
 - name: Web portal navigation
   items:
   - name: Navigation 

diff --git a/docs/index.yml b/docs/index.yml
@@ -232,31 +232,31 @@ additionalContent:
         # Card
         - title: Cross-service, Wikis, Public Projects
           links:
-            - text: Search
-              url: ./project/search/get-started-search.md  
-            - text: Work across projects
-              url: ./project/navigation/work-across-projects.md  
-            - text: Work across projects FAQs
-              url: ./project/work-across-projects-faqs.yml  
+            - text: Cross-service integration and collaboration overview 
+              url: ./cross-service/cross-service-overview.md?toc=/azure/devops/project/toc.json&bc=/azure/devops/project/breadcrumb/toc.json   
             - text: End-to-end traceability
               url: ./cross-service/end-to-end-traceability.md
+            - text: Work across projects
+              url: ./project/navigation/work-across-projects.md  
             - text: Create a wiki for your project
               url: ./project/wiki/wiki-create-repo.md
             - text: Syntax guidance for Markdown usage in Wiki
               url: ./project/wiki/wiki-markdown-guidance.md
-            - text: Create a public project
-              url: ./organizations/public/create-public-project.md
             - text: "See more >"
               url: ./project/index.yml
         # Card
         - title: GitHub integration
           links:
+            - url: ./cross-service/github-integration.md?toc=/azure/devops/project/toc.json&bc=/azure/devops/project/breadcrumb/toc.json 
+              text: GitHub integration 
             - url: ./boards/github/connect-to-github.md
               text: Azure Boards & GitHub
             - url: ./pipelines/create-first-pipeline.md
               text: Azure Pipelines & GitHub
             - url: /azure/devops-project/azure-devops-project-github
               text: Azure DevOps Projects & GitHub
+            - url: /visualstudio/version-control/git-with-visual-studio
+              text: Git experience in Visual Studio
     - title: Configure & customize resources
       items:    
         # Card