Skip to content

Commit 1b002cd

Browse files
committed
refresh
1 parent 66fa289 commit 1b002cd

15 files changed

+224
-358
lines changed

docs/test/add-to-bugs-exploratory-testing.md

+22-27
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Manual and exploratory testing - add findings to existing bugs whe
44
ms.assetid: 0C61F157-452E-4DE5-8998-8DDBD9D44969
55
ms.service: azure-devops-test-plans
66
ms.custom: UpdateFrequency3
7-
ms.topic: conceptual
7+
ms.topic: how-to
88
ms.author: rbatra
99
author: rohit-batra
1010
monikerRange: '<= azure-devops'
@@ -16,55 +16,50 @@ ms.date: 09/14/2021
1616
[!INCLUDE [version-lt-eq-azure-devops](../includes/version-lt-eq-azure-devops.md)]
1717

1818
To help avoid duplication, the Test &amp; Feedback extension automatically
19-
searches for and displays existing bugs, based on the keywords in the title,
20-
as you file a new bug. You can choose to continue creating a new bug or add
21-
your findings to an existing bug.
19+
searches for and displays existing bugs, based on the keywords in the title as you file a new bug. You can choose to continue creating a new bug or add your findings to an existing bug.
2220

2321
[!INCLUDE [prerequisites-define](includes/prerequisites-stakeholder.md)]
2422

25-
1. As you type the title for a new bug, in the background the extension
26-
searches for similar bugs that might be related to the issue you found
27-
and displays a link to the results. Choose this link to see the results that have
28-
similar title keywords.
23+
## Add your findings to a bug
2924

30-
![The link to view similar bugs](media/add-to-bugs-exploratory-testing/add-to-existing-bugs-01.png)
25+
1. Enter the title for a bug.
26+
27+
In the background, the extension searches for similar bugs that might be related to the issue you found and displays a link to the results.
28+
29+
2. Select the link to see the results that have similar title keywords.
30+
31+
![Screenshot showing the link to view similar bugs.](media/add-to-bugs-exploratory-testing/add-to-existing-bugs-01.png)
3132

32-
The form displays **0 Similar** if it doesn't find any matching bugs.
33-
In this case, or if you don't see a "similar" link, you can create a
34-
new bug containing your screenshots, notes, and videos
35-
as described in [this article](connected-mode-exploratory-testing.md).
33+
The form displays **0 Similar** if it doesn't find any matching bugs. In this case, or if you don't see a "similar" link, you can create a new bug that contains your screenshots, notes, and videos, as described in [Connected mode exploratory testing](connected-mode-exploratory-testing.md).
3634

37-
1. If you see a bug you want to update, instead of creating a new one:
35+
3. To update a bug, do the following tasks, rather than create a new one.
3836

39-
- Select it in the list and choose **Edit**.
37+
- Choose it from the list and select **Edit**.
4038

41-
![Editing a similar bug](media/add-to-bugs-exploratory-testing/add-to-existing-bugs-02.png)
39+
![Screenshot showing Editing a similar bug.](media/add-to-bugs-exploratory-testing/add-to-existing-bugs-02.png)
4240

43-
- The extension appends all your screenshots, notes, and videos to
41+
The extension appends all your screenshots, notes, and videos to
4442
the existing bug.
4543

4644
- Save the updated bug.
4745

48-
![Saving the updated bug](media/add-to-bugs-exploratory-testing/add-to-existing-bugs-03.png)
49-
50-
1. If, instead, you decide not to update an existing bug, ignore the "similar" link and:
46+
![Screenshot showing Saving the updated bug.](media/add-to-bugs-exploratory-testing/add-to-existing-bugs-03.png)
5147

52-
- Choose the **New bug** link to return to the bug details form.
48+
4. OR, if you decide not to update an existing bug, ignore the "similar" link and select **New bug** to return to the bug details form.
5349

54-
![Returning to the bug details form](media/add-to-bugs-exploratory-testing/add-to-existing-bugs-04.png)
50+
![Screenshot showing Returning to the bug details form.](media/add-to-bugs-exploratory-testing/add-to-existing-bugs-04.png)
5551

56-
- Enter the details for the new bug and save it
57-
as described in [this article](connected-mode-exploratory-testing.md).<p />
52+
- Enter the details for the new bug and save it, as described in [Connected mode exploratory testing](connected-mode-exploratory-testing.md).
5853

59-
1. Continue exploring your app, filing bugs and tasks, and creating test cases.
54+
5. Continue to explore your app, file bugs and tasks, and create test cases.
6055

6156
## See your exploratory session results
6257

6358
After you file bugs, create tasks, or create test cases, they show up in the "Recent exploratory sessions" page in Azure Test Plans.
6459

65-
* See how you can [view your sessions and get insights](insights-exploratory-testing.md).
60+
See how you can [view your sessions and get insights](insights-exploratory-testing.md).
6661

67-
## See Also
62+
## Related articles
6863

6964
* [Use the Test &amp; Feedback extension in Connected mode](connected-mode-exploratory-testing.md)
7065
* [Explore work items with exploratory testing](explore-workitems-exploratory-testing.md)

docs/test/associate-automated-test-with-test-case.md

+32-49
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Continuous testing. Associate an automated test with a test case us
44
ms.assetid: 606679F2-1604-40EA-A720-63CDDA93DD76
55
ms.service: azure-devops-test-plans
66
ms.custom: UpdateFrequency3
7-
ms.topic: conceptual
7+
ms.topic: how-to
88
ms.author: rbatra
99
author: rohit-batra
1010
ms.date: 12/07/2018
@@ -21,98 +21,80 @@ Consider using Visual Studio to associate automated tests with a test case when:
2121
* You created a manual test case that you later decide is a good test
2222
to automate, but you still want to be able to run that test as part of a test plan.
2323
Tests can be run in the CI/CD pipeline by choosing the test plan or test suite
24-
in the settings of the [Visual Studio Test](/azure/devops/pipelines/tasks/reference/vstest-v2) task.
25-
Automated tests can also be run from the **Test Plans** web portal.
26-
If you're using XAML builds you can also
27-
[run these automated tests by using Microsoft Test Manager](/previous-versions/azure/devops/test/mtm/run-automated-tests-with-microsoft-test-manager).
28-
24+
in the settings of the [Visual Studio Test](/azure/devops/pipelines/tasks/reference/vstest-v2) task. Automated tests can also be run from the **Test Plans** web portal.
25+
If you're using XAML builds, you can also [run these automated tests by using Microsoft Test Manager](/previous-versions/azure/devops/test/mtm/run-automated-tests-with-microsoft-test-manager).
2926
* You want to enable end-to-end traceability of requirements.
3027
If your test cases are linked to requirements or user stories,
3128
the results of the test execution can be used to establish the quality of those requirements.
3229

33-
The process to associate an automated test with a test case is:
30+
## Create a test project and build pipeline
3431

35-
1. Create a test project containing your automated test.
36-
[What types of tests are supported?](#test-types)
32+
Do the following steps to create a test project and build pipeline.
3733

34+
1. Create a test project containing your automated test. [What types of tests are supported?](#test-types)
3835
1. Check your test project into an Azure DevOps.
39-
40-
1. Create a build pipeline for your project, ensuring that it
41-
contains the automated test.
36+
1. Create a build pipeline for your project and ensure that it contains the automated test.
4237
[What are the differences if I'm still using a XAML build?](#xaml-build)
4338

44-
1. Use Visual Studio Enterprise or Professional 2017 or a later version to associate the automated
45-
test with a test case as shown [later in this article](#add-test). The test case were added to a test plan that uses the build you defined.
46-
47-
If you're using the build and release services in
48-
Azure DevOps (not a [XAML build](#xaml-build)), you can run associated tests in the
49-
build and release pipelines by using the
50-
[Visual Studio Test](/azure/devops/pipelines/tasks/reference/vstest-v2) task.
51-
You _can't_ run tests on-demand using Microsoft Test Manager unless you're using a XAML build.
52-
53-
The parameters in a test case aren't used by any automated test that
54-
you associate with a test case. Iterations of a test case that use these
55-
parameters are for manual tests only.
56-
57-
> For more information about checking in your test project and team build, see
58-
[Add files to the server](../repos/tfvc/add-files-server.md)
59-
and [Continuous integration on any platform](../pipelines/get-started/what-is-azure-pipelines.md).
60-
For more information about action recordings and coded UI tests, see
61-
[Recording and Playing Back Manual Tests](/previous-versions/azure/devops/test/mtm/record-play-back-manual-tests)
62-
and [Use UI Automation To Test Your Code](/visualstudio/test/use-ui-automation-to-test-your-code).
63-
6439
<a name="add-test"></a>
40+
6541
## Associate your test
6642

6743
1. Open your solution in Visual Studio Enterprise or Professional 2017 or a later version.
68-
6944
2. If you don't know the identifier of the work item for the test case,
7045
locate the test case in **Azure Test Plans** , or [query for the work item](../boards/queries/using-queries.md) in the **Work** hub.
71-
7246
3. When you know the identifier of the work item for the test case:
7347

74-
**If you are using Visual Studio 2017 or later version**, follow these steps to associate your tests.
48+
**If you are using Visual Studio 2017 or later version**, do the following steps to associate your tests.
7549

7650
- If the **Test Explorer** window isn't displayed, open it from the **Test | Windows** menu.
77-
7851
- If your tests aren't displayed in **Test Explorer**, build the solution.
79-
8052
- In **Test Explorer**, select the test method you want to associate and choose **Associate to Test Case**.
81-
8253
- In the dialog that opens, type the test case identifier and choose **Add Association**, then choose **Save**.
8354

84-
![Associate Automation With Test Case](media/associate-automated-test-with-test-case/test-explorer-associate.png)
55+
![Screenshot showing associating automation with test case.](media/associate-automated-test-with-test-case/test-explorer-associate.png)
8556

86-
> The dialog shows a list of test cases currently associated with the selected test method.
87-
You cannot associate more than one test method with a test case, but you can associate a
57+
The dialog shows a list of test cases currently associated with the selected test method.
58+
You can't associate more than one test method with a test case, but you can associate a
8859
test method with more than one test case.
8960

61+
If you're using the build and release services in Azure DevOps, not a [XAML build](#xaml-build), you can run associated tests in the build and release pipelines by using the[Visual Studio Test](/azure/devops/pipelines/tasks/reference/vstest-v2) task. You _can't_ run tests on-demand using Microsoft Test Manager unless you're using a XAML build.
62+
63+
The parameters in a test case aren't used by any automated test that you associate with a test case. Iterations of a test case that use these parameters are for manual tests only.
64+
65+
For more information, see the following articles:
66+
- [Add files to the server](../repos/tfvc/add-files-server.md)
67+
- [Continuous integration on any platform](../pipelines/get-started/what-is-azure-pipelines.md)
68+
- [Recording and Playing Back Manual Tests](/previous-versions/azure/devops/test/mtm/record-play-back-manual-tests)
69+
- [Use UI Automation To Test Your Code](/visualstudio/test/use-ui-automation-to-test-your-code)
70+
9071
<a name="test-plan"></a>
9172

9273
## FAQs
9374

9475
See the following frequently asked questions (FAQs).
9576

9677
<a name="test-types"></a>
78+
9779
### Q: What types of tests are supported?
9880

99-
**A**: The following limitations exist for each test type:
81+
**A**: The following capabilities and limitations exist for each test type:
10082

101-
* Coded UI test, Selenium tests, and unit tests written using
102-
Version 1 of the MSTest framework **can** be associated with a test case.
83+
* Coded UI test, Selenium tests, and unit tests written using Version 1 of the MSTest framework **can** be associated with a test case.
10384
* Tests that use MSTest v2, NUnit, and xUnit frameworks **can** be associated
10485
with a test case work item when using Visual Studio 15.9 Preview 2 or later.
10586
However, these tests can't be run using Microsoft Test Manager and XAML builds.
10687
* Tests that use the .NET core framework **can** be associated with a test case
10788
work item when using Visual Studio 15.9 Preview 2 or later.
108-
To run the .NET core tests the appropriate target framework must be specified
109-
in a [runsettings file](/visualstudio/test/configure-unit-tests-by-using-a-dot-runsettings-file).
89+
Run the .NET core tests. The appropriate target framework must be specified
90+
in a [runsettings file](/visualstudio/test-configure-unit-tests-by-using-a-dot-runsettings-file).
11091
However, these tests can't be run using Microsoft Test Manager and XAML builds.
11192
* Tests that use other test frameworks such as Chutzpah (for JavaScript tests
11293
such as Mocha or QUnit), or Jest **cannot** be associated with a test case.
11394
* Associating generic tests **may** work, but running these tests isn't supported.
11495

11596
<a name="xaml-build"></a>
97+
11698
### Q: What are the differences if I'm still using a XAML build?
11799

118100
**A**: If you're using a XAML build in Azure Pipelines, you can run tests
@@ -122,15 +104,16 @@ You can also run tests using Microsoft Test Manager and a
122104
[Lab environment](/visualstudio/test/lab-management/using-a-lab-environment-for-your-application-lifecycle).
123105

124106
<a name="open-in-vs"></a>
107+
125108
### Q: Can I configure work items to open in Visual Studio?
126109

127-
**A**: Yes, if you want test work items to open inside Visual Studio
110+
**A**: Yes. If you want test work items to open inside Visual Studio
128111
instead of the default Azure Pipelines UI in your web browser,
129112
change the **Work Items | General** setting from the **Tools | Options** menu in Visual Studio.
130113

131-
![Change work item display mode](media/work-item-compatibility.png)
114+
![Screenshot of Change work item display mode.](media/work-item-compatibility.png)
132115

133-
## See Also
116+
## Related articles
134117

135118
* [Associate automated test results with requirements](../pipelines/test/requirements-traceability.md)
136119
* [Run automated tests from test plans](run-automated-tests-from-test-hub.md)

docs/test/bulk-import-export-test-cases.md

+5-9
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ ms.service: azure-devops-test-plans
66
ms.custom: cross-project, UpdateFrequency3
77
ms.author: rbatra
88
author: raviLiftr
9-
ms.topic: tutorial
9+
ms.topic: how-to
1010
monikerRange: '= azure-devops'
1111
ms.date: 12/04/2023
1212
---
@@ -22,11 +22,11 @@ For an overview of test objects and terminology, see [Test objects and terms](te
2222

2323
## Export test cases
2424

25-
1. From the **Test Plans>Test plans** page, choose the test plan with the test suite containing the test cases you want to export.
25+
1. From the **Test Plans** > **Test plans** page, choose the test plan with the test suite containing the test cases you want to export.
2626

27-
2. Optional. Choose :::image type="icon" source="media/icons/column-options.png"::: **Column options** to add fields to include in the download file.
27+
2. (Optional) Select :::image type="icon" source="media/icons/column-options.png"::: **Column options** to add fields to include in the download file.
2828

29-
3. To export all test cases for the test suite, choose from **Export test cases to CSV** or **Export test cases to XLSX**.
29+
3. To export all test cases for the test suite, select either **Export test cases to CSV** or **Export test cases to XLSX**.
3030

3131
:::image type="content" source="media/bulk-import-test-case/export-test-cases-test-suite.png" alt-text="Screenshot of Export test cases from the selected test suite.":::
3232

@@ -42,14 +42,12 @@ For an overview of test objects and terminology, see [Test objects and terms](te
4242

4343
:::image type="content" source="media/bulk-import-test-case/choose-import-test-cases.png" alt-text="Screenshot of Import test cases to the selected test suite.":::
4444

45-
4645
2. Choose the file to import from the dialog that opens, and then choose **Import**.
4746

4847
:::image type="content" source="media/bulk-import-test-case/import-test-cases-dialog.png" alt-text="Screenshot of Import Test Cases dialog.":::
4948

5049
3. Choose **Confirm** in the **Confirm import** dialog that displays. If you specify test cases that are already defined in the test suite, some elements might get over written during import.
5150

52-
5351
<a id="import-test-cases"></a>
5452

5553
## Update existing test cases
@@ -126,12 +124,11 @@ A: Ensure to follow the below limitations:
126124
* The user performing the import must have permissions on the area and iteration paths for test plan and test suite they're planning to import or export.
127125
* Copy and Import operations fail if the related link count exceeds 1000 for the test case.
128126

129-
## Next step
127+
## Next steps
130128

131129
> [!div class="nextstepaction"]
132130
> [Run manual tests](run-manual-tests.md)
133131
134-
135132
## Related articles
136133

137134
- [Create test plans and test suites](create-a-test-plan.md)
@@ -142,4 +139,3 @@ A: Ensure to follow the below limitations:
142139
- [Test objects and terms](test-objects-overview.md)
143140
- [Create a query based on build and test integration fields](../boards/queries/build-test-integration.md)
144141
- [Customize and manage the test experience](/previous-versions/azure/devops/reference/witadmin/tcm-customize-manage-test-experience)
145-

0 commit comments

Comments
 (0)