Merge pull request #9080 from MicrosoftDocs/users/chcomley/test-plans-curation

[Test Plans] Rework "feedback" articles, curation, and refreshes for TOC, index, and include files

Author: v-dirichards

.openpublishing.redirection.json

@@ -14488,6 +14488,21 @@
       "source_path_from_root": "/docs/pipelines/test/codecoverage-for-pullrequests.md",
       "redirect_url": "/azure/devops/pipelines/test/review-code-coverage-results",
       "redirect_document_id": false
+    },
+    {
+      "source_path": "docs/test/provide-stakeholder-feedback.md",
+      "redirect_url": "/azure/devops/test/request-stakeholder-feedback",
+      "redirect_document_id": true
+    },
+    {
+      "source_path": "docs/test/voluntary-stakeholder-feedback.md",
+      "redirect_url": "/azure/devops/test/request-stakeholder-feedback",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "docs/test/track-stakeholder-feedback.md",
+      "redirect_url": "/azure/devops/test/request-stakeholder-feedback",
+      "redirect_document_id": false
     }
   ]
 }

docs/cross-service/cross-service-overview.md

@@ -123,7 +123,7 @@ Several collaboration scenarios are supported through Azure Boards work item typ
 | Request code review | **Code Review Request** | Tracks information entered into the TFVC New Code Review form. For more information, see [Get your code reviewed with Visual Studio](../repos/tfvc/get-code-reviewed-vs.md). |
 | Provide code review | **Code Review Response** | Tracks review comments provided by code reviewers in [response to a code review request](../repos/tfvc/get-code-reviewed-vs.md#respond-to-the-code-review-request). |
 | Request feedback | **Feedback Request** | Tracks information entered into a request feedback form. Use the following forms to initiate a feedback request. <br> - [Request stakeholder feedback](../test/request-stakeholder-feedback.md) <br> - [Get feedback](/previous-versions/azure/devops/project/feedback/get-feedback). |
-| Provide feedback | **Feedback Review** | Lets stakeholders [provide feedback](../test/provide-stakeholder-feedback.md) based on requests for feedback or by [volunteering feedback](../test/voluntary-stakeholder-feedback.md) using the [Microsoft Test & Feedback](https://marketplace.visualstudio.com/items?itemName=ms.vss-exploratorytesting-web) Marketplace extension. |
+| Provide feedback | **Feedback Review** | Lets stakeholders [provide feedback](../test/request-stakeholder-feedback.md#email) based on requests for feedback or by [volunteering feedback](../test/request-stakeholder-feedback.md#voluntary) using the [Microsoft Test & Feedback](https://marketplace.visualstudio.com/items?itemName=ms.vss-exploratorytesting-web) Marketplace extension. |
 | Manual testing | **Test Plan** | Groups one or more test suites and individual test cases together. Test plans include static test suites, requirement-based suites, and query-based suites. To get started, see [Create test plans and test suites](../test/create-a-test-plan.md). |
 | Manual testing | **Test Suite** | Groups one or more test cases into separate testing scenarios within a single test plan. Grouping test cases makes it easier to see which scenarios are complete. |
 | Manual testing | **Test Case** | 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](../test/create-test-cases.md) 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. |

docs/project/feedback/index.md

@@ -48,9 +48,8 @@ As users perform exploratory testing, you can [gain insights from the sessions](
 
 For more information, see the following articles:  
 
-- [Install the Test & Feedback extension](../../test/request-stakeholder-feedback.md?toc=/azure/devops/project/toc.json)
-- [Request stakeholder feedback](../../test/request-stakeholder-feedback.md?toc=/azure/devops/project/toc.json)
-- [Provide stakeholder feedback](../../test/provide-stakeholder-feedback.md?toc=/azure/devops/project/toc.json)  
+- [Install the Test & Feedback extension](../../test/perform-exploratory-tests.md)
+- [Request and provide stakeholder feedback](../../test/request-stakeholder-feedback.md?toc=/azure/devops/project/toc.json)  
 
 ## Use the Microsoft Feedback client 
 

docs/project/feedback/toc.yml

@@ -2,12 +2,9 @@
   href: index.md
 - name: Test & Feedback extension
   items:
-  - name: Request stakeholder feedback
-    displayName: stakeholder, feedback, request
+  - name: Request and provide stakeholder feedback
+    displayName: stakeholder, feedback, request, provide, voluntary, track
     href: ../../test/request-stakeholder-feedback.md?toc=/azure/devops/project/toc.json
-  - name: Provide stakeholder feedback
-    displayName: stakeholder, feedback, provide
-    href: ../../test/provide-stakeholder-feedback.md?toc=/azure/devops/project/toc.json
   - name: Get insights from tests
     displayName: insights, exploratory
     href: ../../test/insights-exploratory-testing.md
@@ -26,12 +23,6 @@
   - name: Add to existing bugs
     displayName: bugs, exploratory
     href: ../../test/add-to-bugs-exploratory-testing.md
-  - name: Provide feedback without a request
-    displayName: stakeholder, feedback, voluntary
-    href: ../../test/voluntary-stakeholder-feedback.md?toc=/azure/devops/project/toc.json
-  - name: Track stakeholder feedback requests
-    displayName: stakeholder, feedback, response, query
-    href: ../../test/track-stakeholder-feedback.md?toc=/azure/devops/project/toc.json
 - name: Microsoft Feedback client (Archived)
   items:
   - name: Request feedback

docs/project/index.yml

@@ -99,10 +99,8 @@ landingContent:
             url: ./feedback/index.md
       - linkListType: how-to-guide
         links:
-          - text: Request feedback, Test & Feedback extension
+          - text: Request & provide stakeholder feedback
             url: ../test/request-stakeholder-feedback.md?toc=/azure/devops/project/toc.json
           - text: Request feedback, Microsoft Feedback Client
             url: /previous-versions/azure/devops/project/feedback/get-feedback
-          - text: Track feedback
-            url: ../test/track-stakeholder-feedback.md?toc=/azure/devops/project/toc.json
 

docs/test/connected-mode-exploratory-testing.md

@@ -20,8 +20,8 @@ To use the Test & Feedback extension in Connected mode, connect to an Azure DevO
 
 * Users with **Basic** access can use the extension to perform exploratory
   testing, as described in this article.
-* Users with **Stakeholder** access can use the extension to respond to feedback requests or to [provide feedback](provide-stakeholder-feedback.md#direct) voluntarily.
-* Users with **Basic** or **Stakeholder** access can use extension to respond to feedback requests sent by the team by choosing the **Provide feedback** link in the email. for more information, see [Provide stakeholder feedback](provide-stakeholder-feedback.md#email).
+* Users with **Stakeholder** access can use the extension to respond to feedback requests or to [provide feedback](request-stakeholder-feedback.md#voluntary) voluntarily.
+* Users with **Basic** or **Stakeholder** access can use extension to respond to feedback requests sent by the team by choosing the **Provide feedback** link in the email. for more information, see [Provide stakeholder feedback](request-stakeholder-feedback.md#email).
 
 ## Prerequisites
 
@@ -53,7 +53,7 @@ To use the Test & Feedback extension in Connected mode, connect to an Azure DevO
    If there are many projects or teams, use the search textbox to find the one you need. 
 
 The extension is now ready to be used in **Connected** mode. 
-Depending on your access level (Basic or Stakeholder), you see the appropriate UI for either [exploratory testing](#create-bugs) or [providing feedback](provide-stakeholder-feedback.md).
+Depending on your access level (Basic or Stakeholder), you see the appropriate UI for either [exploratory testing](#create-bugs) or [providing feedback](request-stakeholder-feedback.md#email).
 The extension remembers your selection and remains connected until the session cookies expire or you explicitly disconnect from the server.
 
 <a name="create-bugs"></a>

docs/test/includes/feedback-header-text.md

@@ -5,13 +5,13 @@ ms.date: 09/30/2025
 
 Stakeholders can respond to feedback requests in Azure DevOps by using the Test & Feedback extension, [Exploratory testing](../perform-exploratory-tests.md).
 
-Users with Basic access can request feedback from stakeholders by using the work-item shortcut menu. If you have Basic access and want to provide feedback, follow the non‑stakeholder workflow described in [Provide stakeholder feedback](../provide-stakeholder-feedback.md#non-stakeholder-feedback).
+Users with Basic access can request feedback from stakeholders by using the work-item shortcut menu. If you have Basic access and want to provide feedback, follow the non‑stakeholder workflow described in [Request and provide stakeholder feedback](../request-stakeholder-feedback.md#non-stakeholder-feedback).
 
 Quick links
-- [Request feedback](../request-stakeholder-feedback.md)
-- [Provide feedback](../provide-stakeholder-feedback.md)
-- [Voluntary feedback](../voluntary-stakeholder-feedback.md)
-- [Track requests](../track-stakeholder-feedback.md)
+- [Request feedback](../request-stakeholder-feedback.md#request)
+- [Provide feedback](../request-stakeholder-feedback.md#email)
+- [Voluntary feedback](../request-stakeholder-feedback.md#voluntary)
+- [Track requests](../request-stakeholder-feedback.md#track)
 
 > [!NOTE]
 > The end-to-end flow described here applies to web apps and to Azure DevOps. To collect feedback for desktop apps or for older versions, use the [Get feedback](/previous-versions/azure/devops/project/feedback/get-feedback) workflow.

docs/test/includes/important-note-request-feedback-unavailable.md

@@ -9,5 +9,5 @@ ms.date: 09/30/2025
 > The **Request feedback** shortcut menu isn't available in Azure DevOps Services. Use one of these alternatives:
 >
 > - Send an email or chat message to the stakeholders you want to reach, or
-> - Use the [Test & Feedback extension](../voluntary-stakeholder-feedback.md) to collect feedback directly from a browser.
+> - Use the [Test & Feedback extension](../request-stakeholder-feedback.md#voluntary) to collect feedback directly from a browser.
 >

docs/test/index.yml

@@ -1,94 +1,135 @@
 ### YamlMime:Landing
 
 title: Azure Test Plans documentation
-summary: Improve your overall code quality by using manual and exploratory testing services for your apps.
+summary: Plan, execute, and track manual, exploratory, and automated tests to ship high-quality software with Azure DevOps.
 
 metadata:
   title: Azure Test Plans documentation
   titleSuffix: Azure DevOps 
-  description: Test your software using manual and exploratory testing services to improve your overall code quality. 
+  description: Plan, run, and track manual and exploratory tests, collect stakeholder feedback, and review automated test results with Azure Test Plans.
   ms.service: azure-devops-test-plans
   ms.custom: UpdateFrequency3
   ms.assetid: 00f4ed452-fbb8-45f9-8f0a-343702aac5b8  
   ms.topic: landing-page 
   ms.author: pliaros
   author: chcomley
-  ms.date: 07/18/2025
+  ms.date: 03/30/2026
   ms.update-cycle: 1095-days
 
 # linkListType: architecture | concept | deploy | download | get-started | how-to-guide | learn | overview | quickstart | reference | tutorial | video | whats-new
 
 landingContent:
-# Cards and links should be based on top customer tasks or top subjects
-# Start card title with a verb
-  # Card (optional)
-  - title: About Azure Test Plans
+  # Card 1 — Get started
+  - title: Get started
     linkLists:
       - linkListType: overview
         links:
           - text: What is Azure Test Plans?
-            url: ../test/overview.md
+            url: overview.md
           - text: Navigate Test Plans
-            url: ../test/navigate-test-plans.md
-          - text: Store custom data in test plan and/or test result
-            url: ../test/custom-fields.md
-  - title: Run manual tests
+            url: navigate-test-plans.md
+          - text: Test objects and terms
+            url: test-objects-overview.md
+      - linkListType: get-started
+        links:
+          - text: Default permissions (Security)
+            url: manual-test-permissions.md
+  # Card 2 — Test plans, suites & cases
+  - title: Create test plans, suites & cases
     linkLists:
-      - linkListType: quickstart
+      - linkListType: how-to-guide
         links:
           - text: Create test plans and suites
-            url: ../test/create-a-test-plan.md
-          - text: Create manual test cases
-            url: ../test/create-test-cases.md
-          - text: Run manual tests
-            url: ../test/run-manual-tests.md
-      - linkListType: tutorial
+            url: create-a-test-plan.md
+          - text: Create test cases
+            url: create-test-cases.md
+          - text: Share steps between test cases
+            url: share-steps-between-test-cases.md
+          - text: Copy or clone test plans, suites, cases
+            url: copy-clone-test-items.md
+          - text: Bulk import and export (CSV/XLSX)
+            url: bulk-import-export-test-cases.md
+  # Card 3 — Run manual tests
+  - title: Run manual tests
+    linkLists:
+      - linkListType: how-to-guide
         links:
+          - text: Run manual tests
+            url: run-manual-tests.md
           - text: Test different configurations
-            url: ../test/test-different-configurations.md
-  - title: Test & Feedback extension
+            url: test-different-configurations.md
+          - text: Repeat a test with different data
+            url: repeat-test-with-different-data.md
+          - text: Perform user acceptance testing
+            url: user-acceptance-testing.md
+          - text: Collect diagnostic data
+            url: collect-diagnostic-data.md
+  # Card 4 — Exploratory testing
+  - title: Exploratory testing
     linkLists:
-      - linkListType: quickstart
+      - linkListType: how-to-guide
         links:
           - text: Install the Test & Feedback extension
-            url: ../test/perform-exploratory-tests.md
+            url: perform-exploratory-tests.md
           - text: Test in Connected mode
-            url: ../test/connected-mode-exploratory-testing.md
-  - title: Configure Test resources
+            url: connected-mode-exploratory-testing.md
+          - text: Test in Standalone mode
+            url: standalone-mode-exploratory-testing.md
+          - text: Explore work items
+            url: explore-workitems-exploratory-testing.md
+          - text: Get insights from sessions
+            url: insights-exploratory-testing.md
+  # Card 5 — Stakeholder feedback
+  - title: Stakeholder feedback
     linkLists:
       - linkListType: how-to-guide
         links:
-          - text: Set test retention policies
-            url: ../test/how-long-to-keep-test-results.md?toc=/azure/devops/organizations/toc.json 
-          - text: Manage test runs
-            url: ../test/test-runs.md
-      - linkListType: reference
-        links:
-          - text: Test Plans FAQs
-            url: ../test/reference-qa.yml
+          - text: Request and provide stakeholder feedback
+            url: request-stakeholder-feedback.md
+  # Card 6 — Automated tests
   - title: Run automated tests
     linkLists:
-      - linkListType: concept
+      - linkListType: how-to-guide
         links:
-          - text: Run automated tests from test hub
-            url: ../test/run-automated-tests-from-test-hub.md
           - text: Associate automated tests with test cases
-            url: ../test/associate-automated-test-with-test-case.md
-  - title: Set up continuous testing
-    linkLists:
+            url: associate-automated-test-with-test-case.md
+          - text: Run automated tests from test plans
+            url: run-automated-tests-from-test-hub.md
       - linkListType: tutorial
         links:
-          - text: .NET Core apps
-            url: ../pipelines/ecosystems/dotnet-core.md
-          - text: Go
-            url: ../pipelines/ecosystems/go.md#test
-          - text: Python
-            url: ../pipelines/ecosystems/customize-python.md#run-tests
-          - text: UI testing using Selenium
-            url: ../pipelines/test/continuous-test-selenium.md
           - text: Review code coverage results
             url: ../pipelines/test/review-code-coverage-results.md
           - text: Review test results
             url: ../pipelines/test/review-continuous-test-results-after-build.md
           - text: Analyze test results
             url: ../pipelines/test/test-analytics.md
+  # Card 7 — Track progress
+  - title: Track progress and results
+    linkLists:
+      - linkListType: how-to-guide
+        links:
+          - text: Manage test runs
+            url: test-runs.md
+          - text: Track test status
+            url: track-test-status.md
+          - text: Progress report
+            url: progress-report.md
+      - linkListType: reference
+        links:
+          - text: Pipeline Analytics
+            url: ../pipelines/reports/pipelinereport.md
+          - text: Flaky test management
+            url: ../pipelines/test/flaky-test-management.md
+  # Card 8 — Reference & troubleshooting
+  - title: Reference & troubleshooting
+    linkLists:
+      - linkListType: reference
+        links:
+          - text: Test case management commands (tcm.exe)
+            url: test-case-managment-reference.md
+          - text: Work item field index
+            url: ../boards/work-items/guidance/work-item-field.md
+          - text: Manual testing FAQs
+            url: reference-qa.yml
+          - text: REST API - Test Plans
+            url: /rest/api/azure/devops/testplan/test-plans

docs/test/overview.md

@@ -270,7 +270,7 @@ to feedback requests using the browser-based Test & Feedback extension -
 not just to rate and send comments, but also by capturing rich diagnostic
 data and filing bugs and tasks directly.
 See more at [Request stakeholder feedback](request-stakeholder-feedback.md) 
-and [Provide stakeholder feedback](provide-stakeholder-feedback.md).
+and [Provide stakeholder feedback](request-stakeholder-feedback.md#email).
 
 ![Requesting and providing stakeholder feedback](media/manual-testing/stakeholder-feedback-01.png)