Skip to content

Commit 06bb2f5

Browse files
committed
refresh
1 parent 1b002cd commit 06bb2f5

23 files changed

+414
-642
lines changed

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

+2-2
Original file line numberDiff line numberDiff line change
@@ -45,7 +45,7 @@ Do the following steps to create a test project and build pipeline.
4545
locate the test case in **Azure Test Plans** , or [query for the work item](../boards/queries/using-queries.md) in the **Work** hub.
4646
3. When you know the identifier of the work item for the test case:
4747

48-
**If you are using Visual Studio 2017 or later version**, do the following steps to associate your tests.
48+
**If you're using Visual Studio 2017 or later version**, do the following steps to associate your tests.
4949

5050
- If the **Test Explorer** window isn't displayed, open it from the **Test | Windows** menu.
5151
- If your tests aren't displayed in **Test Explorer**, build the solution.
@@ -87,7 +87,7 @@ See the following frequently asked questions (FAQs).
8787
* Tests that use the .NET core framework **can** be associated with a test case
8888
work item when using Visual Studio 15.9 Preview 2 or later.
8989
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).
90+
in a [.runsettings file](/visualstudio/test/configure-unit-tests-by-using-a-dot-runsettings-file?view=vs-2022).
9191
However, these tests can't be run using Microsoft Test Manager and XAML builds.
9292
* Tests that use other test frameworks such as Chutzpah (for JavaScript tests
9393
such as Mocha or QUnit), or Jest **cannot** be associated with a test case.

docs/test/create-a-test-plan.md

+5-6
Original file line numberDiff line numberDiff line change
@@ -92,24 +92,23 @@ To delete a test plan, do the following steps.
9292
In general, you create test plans to test requirements. Before you create a test plan, [define your backlog of requirements](../boards/backlogs/create-your-backlog.md).
9393

9494
1. From the web portal, open your project and go to **Test Plans**.
95-
If you already have a test plan, choose **Test Plans** to go to the page that lists all test plans.
95+
If you already have a test plan, select **Test Plans** to go to the page that lists all test plans.
9696

9797
![Screenshot showing opening the list of test plans page.](media/create-a-test-plan/goto-test-plans-page.png)
9898

99-
2. In the **Test Plans** page, choose **New Test Plan** to create a test plan for your current sprint.
99+
2. Select **New Test Plan**.
100100

101101
![Screenshot showing creating a new test plan.](media/create-a-test-plan/CreateATestPlan1a.png)
102102

103-
3. In **New Test Plan**, enter a name for the test plan.
104-
Verify that the area path and iteration are set correctly, then choose **Create**.
103+
3. Enter a name for the test plan, verify that the area path and iteration are set correctly, and then select **Create**.
105104

106105
![Screenshot showing adding test plan details.](media/create-a-test-plan/CreateATestPlan2.png)
107106

108107
### Rename a test plan
109108

110109
To rename a test plan, open it from the shortcut menu and rename it.
111110

112-
![Screenshot showing rename a test plan.](media/create-a-test-plan/rename-test-plan.png)
111+
![Screenshot showing renaming a test plan.](media/create-a-test-plan/rename-test-plan.png)
113112

114113
### Delete a test plan
115114

@@ -190,7 +189,7 @@ You can track changes to test plans and test suites. Open the work item for the
190189

191190
For test suites, other actions are tracked in the **Test Suite Audit** field. For example, adding and removing test cases from a test suite are tracked in this field.
192191

193-
You can export test plans, test suites, and test cases.
192+
Export test plans, test suites, and test cases.
194193

195194
::: moniker range=">=azure-devops-2020"
196195
Select **Export test cases to CSV**.

docs/test/create-test-cases.md

+41-57
Original file line numberDiff line numberDiff line change
@@ -21,9 +21,7 @@ ms.date: 11/04/2021
2121

2222
Create manual test cases to check that each deliverable meets your users' needs. Manual test cases define individual steps testers perform, including steps that are shared across test cases. To test different data, you specify parameters for the test steps. For more information, see [Share steps between test cases](share-steps-between-test-cases.md) and [Repeat a test with different data](repeat-test-with-different-data.md). For an overview of test artifacts, see [Test objects and terms](test-objects-overview.md).
2323

24-
Organize your test cases by adding them to test plans and test suites. Then assign testers to run the tests.
25-
26-
For an overview of test artifacts, see [Test objects and terms](test-objects-overview.md).
24+
Organize your test cases by adding them to test plans and test suites, and then assign testers to run the tests. For more information, see [Test objects and terms](test-objects-overview.md).
2725

2826
> [!NOTE]
2927
> Test iterations are designed to support data-driven scenarios, not workflow-driven scenarios.
@@ -37,74 +35,62 @@ For an overview of test artifacts, see [Test objects and terms](test-objects-ove
3735
<a name="createcase"></a>
3836

3937
## Create test cases
38+
4039
::: moniker range=">=azure-devops-2020"
4140
1. If you haven't already, [create a test plan and requirement-based test suites](create-a-test-plan.md).
4241

43-
1. Select a requirement-based test suite.
44-
To the right, select the **New Test Case** button.
42+
2. Select a requirement-based test suite and select **New Test Case**.
4543

4644
![Screenshot showing test cases with New Test Case button highlighted.](media/create-test-cases/new-test-case-button.png)
4745

48-
If you have no existing test cases, the button appears in the lower right.
49-
5046
> [!NOTE]
51-
> The [test suite](create-a-test-plan.md) shown here was created from a User Story work item in the team's backlog board.
52-
> When you add a test case to this kind of suite, the test case is automatically linked to the backlog item.
53-
> To create test cases this way, open the context menu for the work item and choose **Add test**.
47+
> The [test suite](create-a-test-plan.md) shown here was created from a User Story work item in the team's backlog board. When you add a test case to this kind of suite, the test case automatically links to the backlog item. To create test cases this way, open the context menu for the work item and choose **Add test**.
5448
55-
1. In the new work item, enter a title. Select the **Click or type here to add a step** option.
49+
3. In the new work item, enter a title and select **Click or type here to add a step**.
5650

5751
![Screenshot showing the steps entered for a test case.](media/create-test-cases/test-case-steps.png)
5852

59-
Add test steps with a description of the action required to carry out the test and the expected results so that any team member can run the test.
60-
You can add attachments to a step if you want.
61-
Repeat until you add all the steps for the test.
62-
63-
> [!NOTE]
64-
> You can share steps between test cases. For more information, see [Share steps](share-steps-between-test-cases.md).
53+
4. Add test steps with a description of the action required to carry out the test and the expected results so that any team member can run the test. You can add attachments to a step if you want. Repeat until you add all the steps for the test.
6554

6655
A test case that you can run gets created.
67-
68-
You can also copy test cases. For more information, see [Copy or clone stories, issues and other work items](../boards/backlogs/copy-clone-work-items.md).
56+
57+
For more information, see [Share steps](share-steps-between-test-cases.md) and [Copy or clone stories, issues and other work items](../boards/backlogs/copy-clone-work-items.md).
6958

7059
## Assign configurations to test cases
7160

7261
You can specify configurations, such as different operating systems, web browsers, and other variations for your tests.
7362

74-
To assign test configurations to all test cases in a test suite, select the test suite, select **More options** or right-click to open the context menu, and then select **Assign configurations**.
75-
76-
In the **Assign configurations to test suite** dialog box, select the configurations you want.
63+
1. Select the test suite > **More options** > **Assign configurations**, and in the dialog box, select your configurations.
7764

7865
![Screenshot showing the Assign configurations to test suite dialog box with some options selected.](media/create-test-cases/assign-configurations-test-suite.png)
7966

80-
You can also assign configurations to individual test cases. Select one or more test cases, select **More options** or right-click to open the context menu, and then select **Assign configuration**.
81-
82-
The **Assign configurations to selected test cases** dialog box opens. Make and save your changes.
67+
You can also assign configurations to individual test cases. Select one or more test cases, select **More options** > **Assign configuration**.
68+
69+
1. Make your changes and then **Save**.
8370

84-
For more information about configurations, see [Test different configurations](test-different-configurations.md).
71+
For more information, see [Test different configurations](test-different-configurations.md).
8572

8673
## Reorder test cases
8774

8875
You can reorder manual test cases in static suites, requirement-based suites, and query-based suites.
89-
Open a test case, then use the up and down arrows to change the order.
9076

91-
![Screenshot showing the arrows used to move test steps up or down.](media/create-test-cases/change-step-order.png)
77+
Open a test case, and then use the up and down arrows to change the order.
9278

93-
There are also options to change order in the step context menu.
79+
![Screenshot showing the arrows used to move test steps up or down.](media/create-test-cases/change-step-order.png)
9480

9581
## Add existing test cases to a test suite
9682

97-
You can add existing test cases to a test suite.
83+
Add existing test cases to a test suite with the following actions.
9884

99-
1. Select a test suite. From the **New Test Case** menu, select **Add existing test case**.
85+
1. Select a test suite. From the **New Test Case** menu, select **Add existing test cases**.
10086

10187
![Screenshot showing the Add existing test cases option to select.](media/create-test-cases/add-existing-test-cases.png)
10288

103-
1. In the **Add test cases to suite** dialog box, add search clauses, as needed, and then select **Run query**.
89+
1. Add search clauses, as needed, and then select **Run query**.
10490

10591
![Screenshot showing the Add test cases to suite dialog box with the Run query button highlighted.](media/create-test-cases/add-test-case-suite.png)
10692

107-
1. After you find the test cases you want, select **Add test cases**.
93+
2. When you find the test cases you want, highlight them and select **Add test cases**.
10894

10995
::: moniker-end
11096

@@ -141,36 +127,33 @@ After reordering the tests, you can sort them by the **Order** field and then ru
141127
::: moniker-end
142128

143129
> [!TIP]
144-
> You can create a test case that automatically links to a requirement&mdash;User Story ([Agile](../boards/work-items/guidance/agile-process.md)), Product Backlog Item ([Scrum](../boards/work-items/guidance/scrum-process.md)), Requirement ([CMMI](../boards/work-items/guidance/cmmi-process.md)), or Issue ([Basic](../boards/get-started/plan-track-work.md))&mdash;when you create a test from the Kanban board. For more information, see [Add, run, and update inline tests](../boards/boards/add-run-update-tests.md).
145-
>
130+
> You can create a test case that automatically links to a requirement&mdash;User Story ([Agile](../boards/work-items/guidance/agile-process.md)), Product Backlog Item ([Scrum](../boards/work-items/guidance/scrum-process.md)), Requirement ([CMMI](../boards/work-items/guidance/cmmi-process.md)), or Issue ([Basic](../boards/get-started/plan-track-work.md))&mdash;when you create a test from the Kanban board. For more information, see [Add, run, and update inline tests](../boards/boards/add-run-update-tests.md).
146131
147132
## Use the Grid view to edit test cases
148133
::: moniker range=">=azure-devops-2020"
149134

150-
You can copy and paste test cases into the **Grid** view.
135+
Do the following steps to copy and paste test cases into the **Grid** view.
151136

152-
To open the **Grid** view, select the **Grid View** icon at the right.
137+
1. Select the **Grid View** icon.
153138

154-
![Screenshot showing the Grid View button used to open the Grid view.](media/create-test-cases/grid-view-button.png)
139+
![Screenshot showing the Grid View button used to open the Grid view.](media/create-test-cases/grid-view-button.png)
155140

156-
Instead, you can select several test cases and open them for editing in the **Grid** view. In the context menu, select **Edit test case(s) in grid**.
141+
2. Select one to several test cases, and then select **Edit test case(s) in grid**.
157142

158-
![Screenshot showing several test cases selected with the context menu open and Edit test case(s) in grid selected.](media/create-test-cases/edit-multiple-test-cases-grid.png)
143+
![Screenshot showing several test cases selected with the context menu open and Edit test case(s) in grid selected.](media/create-test-cases/edit-multiple-test-cases-grid.png)
159144

160-
On the **Grid** context menu, you can add, delete, or clear rows.
145+
3. Add, delete, or clear rows.
161146

162-
![Screenshot showing the Grid context menu to insert, delete, or clear rows.](media/create-test-cases/grid-context-menu.png)
147+
![Screenshot showing the Grid context menu to insert, delete, or clear rows.](media/create-test-cases/grid-context-menu.png)
163148

164-
You can use the **Grid** view when you add multiple test cases to the test suite:
149+
4. Optional. To add multiple test cases to the test suite, select **Add test cases using grid**.
165150

166-
![Screenshot showing option to add test cases using the Grid view.](media/create-test-cases/add-test-cases-grid.png)
151+
![Screenshot showing option to add test cases using the Grid view.](media/create-test-cases/add-test-cases-grid.png)
152+
- In the **List** view, use the column options to select the fields in the test case work item.
167153

168-
You can edit other fields in the **Grid** view.
169-
In the **List** view, use the column options to select the fields in the test case work item.
170-
171-
![Screenshot showing the Column Options button.](media/create-test-cases/column-options.png)
154+
![Screenshot showing the Column Options button.](media/create-test-cases/column-options.png)
172155

173-
You can then view and edit these fields when you switch to the **Grid** view.
156+
View and edit these fields when you switch to the **Grid** view.
174157
::: moniker-end
175158

176159
::: moniker range="<=azure-devops-2019"
@@ -188,7 +171,7 @@ You can use the **Grid View** when you add multiple test cases to the test suite
188171
> [!NOTE]
189172
> Do not use the Teams plugin for Excel to add or update test case work items.
190173
> Excel cannot parse the format used to store test steps, and in some cases
191-
> this may affect the formatting of the test case work items.
174+
> this might affect the formatting of the test case work items.
192175
193176
You can edit other fields in the **Grid** view.
194177
In the **List** view, use the column options to select the fields in the test case work item.
@@ -198,7 +181,7 @@ In the **List** view, use the column options to select the fields in the test ca
198181
You can then view and edit these fields when you switch to the Grid view.
199182
::: moniker-end
200183

201-
### Use Excel to copy test case information into a Grid view
184+
### Use Excel to copy information into a Grid view
202185
::: moniker range=">=azure-devops-2020"
203186
You can copy test cases and test steps from an existing Excel worksheet.
204187
Copy the columns from Excel that you want to use for the title, action, and expected results fields.
@@ -211,8 +194,8 @@ You can copy the data from the **Grid** view and paste it into your Excel worksh
211194
Copying doesn't copy test step formatting, other than multiline, into the worksheet.
212195

213196
> [!NOTE]
214-
> Do not use the Teams plugin for Excel to add or update test case work items.
215-
> Excel cannot parse the format used to store test steps, and in some cases this may affect the formatting of the test case work items.
197+
> Don't use the Teams plugin for Excel to add or update test case work items.
198+
> Excel can't parse the format used to store test steps, and in some cases this may affect the formatting of the test case work items.
216199
217200
::: moniker-end
218201

@@ -290,10 +273,11 @@ You can assign an individual test case to a tester.
290273
::: moniker range=">=azure-devops-2020"
291274

292275
You can open a test case to view it or edit it.
293-
To open a test case in a test suite, in the **Define** tab, double-select the name of the test case to open.
294-
In the **Execute** tab, select a test case, open its context menu, and select **Edit test case**.
295276

296-
![Screenshot show the Edit test case option for a test case in the context menu](media/create-test-cases/open-test-case-edit.png)
277+
1. To open a test case in a test suite, in the **Define** tab, double-select the name of the test case to open.
278+
2. In the **Execute** tab, select a test case, open its context menu, and select **Edit test case**.
279+
280+
![Screenshot showing the Edit test case option for a test case in the context menu](media/create-test-cases/open-test-case-edit.png)
297281

298282
A test case can be linked to test suites, requirements, and bugs.
299283
To see linked items, in the **Define** tab, open the context menu for a test case, and select **View Linked Items**.
@@ -370,7 +354,7 @@ To manage or delete test artifacts, you must also have your access level set to
370354
To delete test plans and test suites, you must be a member of the Project Administrators group or have the Area Path node-level [**Manage test plans** or **Manage test suites**](../organizations/security/set-permissions-access-work-tracking.md#manage-test-artifacts) permission set to **Allow**. To manage or delete test artifacts, you must also have your [access level](../organizations/security/access-levels.md) set to **Basic + Test Plans** or **Visual Studio Enterprise**. For more information, see [Delete test artifacts in Azure Boards](../boards/backlogs/delete-test-artifacts.md).
371355
::: moniker-end
372356

373-
## Next step
357+
## Next steps
374358

375359
> [!div class="nextstepaction"]
376360
> [Run manual tests](run-manual-tests.md)

docs/test/explore-workitems-exploratory-testing.md

+4-4
Original file line numberDiff line numberDiff line change
@@ -39,15 +39,15 @@ Explore the following items:
3939

4040
![Screenshot showing the banner with the work item for your session.](media/explore-workitems-exploratory-testing/explore-workitems-02.png)
4141

42-
1. Launch the Test &amp; Feedback extension.
43-
Any acceptance criteria for the work item is shown.
42+
2. Launch the Test & Feedback extension.
43+
Any acceptance criteria for the work item are shown.
4444

4545
![Screenshot showing launching the Test - Feedback extension.](media/explore-workitems-exploratory-testing/explore-workitems-03.png)
4646

4747
If you didn't already start a session, start one now.
48-
The work item is automatically associated with the current or new session.
48+
The work item automatically associates with the current or new session.
4949

50-
1. All bugs, tasks, and test cases you create automatically link to the current work item.
50+
3. All bugs, tasks, and test cases you create automatically link to the current work item.
5151

5252
![Screenshot showing view of the current work item.](media/explore-workitems-exploratory-testing/explore-workitems-04.png)
5353

0 commit comments

Comments
 (0)