diff --git a/docs/cross-service/cross-service-overview.md b/docs/cross-service/cross-service-overview.md index 23bf733d351..2bccf0c7a67 100644 --- 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—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 index 86d8fcca870..c93ae991014 100644 --- 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) \ No newline at end of file +- [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) \ No newline at end of file diff --git a/docs/cross-service/media/overview/concept-link-types-pipelines.png b/docs/cross-service/media/overview/concept-link-types-pipelines.png index 6e107109011..7235c8d0e15 100644 Binary files a/docs/cross-service/media/overview/concept-link-types-pipelines.png and b/docs/cross-service/media/overview/concept-link-types-pipelines.png differ diff --git a/docs/cross-service/media/overview/concept-link-types-repos.png b/docs/cross-service/media/overview/concept-link-types-repos.png index febbf64ea9b..66bafbc0dad 100644 Binary files a/docs/cross-service/media/overview/concept-link-types-repos.png and b/docs/cross-service/media/overview/concept-link-types-repos.png differ diff --git a/docs/get-started/toc.yml b/docs/get-started/toc.yml index afb15f442f5..d6570883c18 100644 --- 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 index 1156d3c1d01..0d37cdbca68 100644 --- 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