Freshness, in progress.

Author: TimShererWithAquent

docs/boards/includes/prerequisites-work-items.md

@@ -10,11 +10,11 @@ ms.date: 01/13/2025
 | Category | Requirements |
 |--------------|-------------|
 | **Permissions** | - To view, follow, and edit work items: **View work items in this node** and **Edit work items in this node** permissions set to **Allow**. By default, the **Contributors** group has these permissions. For more information, see [Set work tracking permissions](../../organizations/security/set-permissions-access-work-tracking.md). <br> - To add tags to work items: Project-level **Create new tag definition** permission set to **Allow**. By default, the **Contributors** group has this permission. |
-| **Access levels** | - [Project member](../../organizations/security/add-users-team-project.md). <br> - To add new tags to work items or to view or follow pull requests: At least [**Basic** access](../../organizations/security/access-levels.md). <br> - To view or follow work items: At least **Stakeholder** access. For more information, see [About access levels](../../organizations/security/access-levels.md). <br> - All project members, including those in the **Readers** group, can send emails containing work items. |
+| **Access levels** | - [Project member](../../organizations/security/add-users-team-project.md). <br> - To add new tags to work items or to view or follow pull requests: At least [**Basic** access](../../organizations/security/access-levels.md#supported-access-levels). <br> - To view or follow work items: At least **Stakeholder** access. For more information, see [About access levels](../../organizations/security/access-levels.md). <br> - All project members, including members in the **Readers** group, can send emails containing work items. |
 
 ::: moniker range="azure-devops" 
   >[!NOTE]
-  >- Provide [Stakeholder access](../../organizations/security/access-levels.md) to members who want to contribute to the discussion and review progress. These are typically members who don't contribute to code, but want to view work items, backlogs, boards, and dashboards. 
+  >- Provide [Stakeholder access](../../organizations/security/access-levels.md#supported-access-levels) to members who want to contribute to the discussion and review progress. These members typically don't contribute to code, but want to view work items, backlogs, boards, and dashboards. 
   >- By default, all **Contributors** and **Stakeholders** in public projects can add new and existing tags. In private projects, Stakeholders can only add existing tags. To control the ability to create new tags, set the **Create tag definition** permission at the project level. For more information, see [Change project-level permissions](../../organizations/security/change-project-level-permissions.md).
 ::: moniker-end
 

docs/boards/includes/query-clause-tip.md

@@ -6,6 +6,5 @@ ms.topic: include
 ms.date: 06/29/2022
 ---
 
-
 > [!TIP]  
-> To understand how `AND/OR` clauses are grouped, see [Create and save managed queries, Group clauses](../queries/using-queries.md#group-clauses). To view the WIQL syntax for a query, install the [WIQL query editor extension](https://marketplace.visualstudio.com/items?itemName=ottostreifel.wiql-editor) which allows you to see the WIQL version of any query editor entry.
+> To understand how `AND/OR` clauses are grouped, see [Group clauses](../queries/using-queries.md#group-clauses). To view the WIQL syntax for a query, install the [WIQL query editor extension](https://marketplace.visualstudio.com/items?itemName=ottostreifel.wiql-editor), which allows you to see the WIQL version of any query editor entry.

docs/boards/queries/add-tags-to-work-items.md

@@ -18,7 +18,7 @@ ms.date: 04/24/2024
 
 Tag work items to quickly filter the product backlog or a work item query by categories that you define. A tag corresponds to a one or two keyword phrase that you define and that supports your needs to filter a backlog or query, or define a query.
 
-Tags are a better choice for filtering work items than using text strings as described in [Define a query/Best practices](using-queries.md).
+Tags are a better choice for filtering work items than using text strings as described in [Define a work item query](using-queries.md).
 
 You can add and modify tags from the web portal, from Team Explorer plug-in for Visual Studio. Also, you can open a query in [Excel](../backlogs/office/bulk-add-modify-work-items-excel.md) to modify tags in bulk.
 
@@ -57,7 +57,7 @@ You bulk modify tags in the same way as you [bulk modify other fields using the
 > ![Screenshot showing Edit work items dialog, Bulk add to several work items.](media/add-tags/bulk-add-tags.png) 
 
 > [!NOTE]   
-> Bulk modifying tags from Visual Studio or other supported clients isn't supported. 
+> Boards doesn't support modifying tags in bulk from Visual Studio or other clients.
 
 <a id="query"></a>
 
@@ -67,9 +67,9 @@ To query work items based on tags, add a clause for each tag you want to use to
 
 [!INCLUDE [temp](../includes/query-clause-tip.md)]
 
-You can use the **Contains** or **Does Not Contain** operators. Tags that start with the `@` character can't be used in a work item query as the query editor interprets the `@` character as a macro. For more information, see [Create managed queries](using-queries.md). 
+You can use the **Contains** or **Does Not Contain** operators. Tags that start with the `@` character can't be used in a work item query as the query editor interprets the `@` character as a macro. For more information, see [Define a work item query](using-queries.md). 
 
-For example, here we query for all work items that are tagged either ```Web``` or ```Service```. 
+For example, here we query for all work items that are tagged as either `Web` or `Service`. 
 
 > [!div class="mx-imgBorder"]
 > ![Screenshot of Query Editor to query on tags.](media/add-tags/query-tags-add-or.png) 
@@ -116,7 +116,7 @@ Another option is to install the [Marketplace Tags Manager](https://marketplace.
 
 ## Color-code tags on boards
 
-Highlight tags on board cards by color-coding them. These colors only appear on the board that you configure. They don't appear on backlogs or Taskboards. For more information, see [Customize cards, color-code tags](../boards/customize-cards.md). 
+Highlight tags on board cards by color-coding them. These colors only appear on the board that you configure. They don't appear on backlogs or Taskboards. For more information, see [Assign tag colors](../boards/customize-cards.md#assign-tag-colors). 
 
 > [!div class="mx-imgBorder"]
 > ![Screenshot of sequence, Boards, Settings, Tag colors dialog.](media/add-tags/color-code-tags.png)
@@ -128,7 +128,7 @@ Highlight tags on board cards by color-coding them. These colors only appear on
 
 You can't group a query-based chart by tags, but, you can group a **Chart for Work Items** widget by tags that you add to a dashboard.    This feature is in public preview. To enable it, see [Manage or enable features](../../project/navigation/preview-features.md) and turn on **Enable group by tags for work item chart widget on dashboard**. 
 
-To group a **Chart for Work Items** widget by tags, complete the same steps provided in [Track progress with status and trend query-based charts, Add a chart widget to a dashboard](../../report/dashboards/charts.md). Make sure that your flat-list query contains **Tags** in the query clause or as a column option. Then, choose **Tags** for the **Group by** selection. To filter the chart to show only some tags, choose the **Selected tags** radio button and then choose the tags you want the chart to display.  
+To group a **Chart for Work Items** widget by tags, complete the same steps provided in [Add a chart to a dashboard](../../report/dashboards/charts.md#add-a-chart-to-a-dashboard). Make sure that your flat-list query contains **Tags** in the query clause or as a column option. Then, choose **Tags** for the **Group by** selection. To filter the chart to show only some tags, choose the **Selected tags** radio button and then choose the tags you want the chart to display.  
 
 :::image type="content" source="../../report/dashboards/media/charts/configure-chart-widget-tags.png" alt-text="Screenshot of Chart by Work Items, Configure, Group by Tags.":::
 
@@ -158,8 +158,8 @@ To add the **Tags** field as a column field for the product backlog, you modify
 
 ## Related content
 
-- [Use the query editor to list and manage queries](using-queries.md) 
-- [Show tags on cards](../../boards/boards/customize-cards.md)
+- [Define a work item query](using-queries.md) 
+- [Customize cards on a board](../../boards/boards/customize-cards.md)
 - [Bulk modify work items from the web portal](../backlogs/bulk-modify-work-items.md)  
 - [Bulk modify work items from Excel](../backlogs/office/bulk-add-modify-work-items-excel.md)