refresh ms.subservice top 10: azure-devops-projects

Author: chcomley

docs/boards/backlogs/media/filter-backlogs-options.png

@@ -6,12 +6,12 @@ brand: azure
 
 metadata:
   title: Azure DevOps documentation
-  description: Collaborate on software development through source control, work tracking, and continuous integration and delivery, both on-premises and in the cloud!
+  description:  Collaborate on software development with source control, work tracking, and continuous integration and delivery, both on-premises and in the cloud!
   ms.topic: hub-page 
   ms.subservice: azure-devops-projects
   ms.author: chcomley
   author: chcomley
-  ms.date: 09/17/2022
+  ms.date: 03/11/2025
 
 # highlightedContent section (optional)
 # Maximum of 8 items
@@ -47,7 +47,7 @@ highlightedContent:
       itemType: how-to-guide
       url: ./organizations/projects/connect-to-projects.md
     # Card
-    - title: Authenticate with Azure DevOps
+    - title: Secure access to Azure DevOps
       itemType: how-to-guide
       url: ./integrate/get-started/authentication/authentication-guidance.md
 # productDirectory section (optional)

docs/index.yml

@@ -9,15 +9,15 @@ ms.topic: how-to
 ms.author: chcomley
 author: chcomley
 monikerRange: '>= azure-devops-2019'
-ms.date: 12/17/2024
+ms.date: 03/11/2025
 ---
 
 
 # Create a project in Azure DevOps
 
 [!INCLUDE [version-gt-eq-2019](../../includes/version-gt-eq-2019.md)] 
 
-Create an Azure DevOps project to establish a repository for source code and to plan and track work. You can manage and structure your project to support your business needs. Each project provides boundaries to isolate data from other projects. For more information, see [About projects and scaling your organization](about-projects.md).
+Create an Azure DevOps project to set up a source code repository and organize your work. You can tailor and manage your project to meet your business requirements. Each project isolates its data from other projects. For more information, see [About projects and scaling your organization](about-projects.md).
 
 [!INCLUDE [version-selector](../../includes/version-selector.md)]
 
@@ -49,7 +49,7 @@ Create an Azure DevOps project to establish a repository for source code and to
 ::: moniker range="azure-devops"
 
 > [!IMPORTANT]  
-> To create a public project or [make a private project public](../projects/make-project-public.md), enable additional policy settings to work with public projects, and then return to this article to create your project.
+> To create a public project or [make a private project public](../projects/make-project-public.md), enable other policy settings to work with public projects, and then return to this article to create your project.
 
 ::: moniker-end
 
@@ -111,7 +111,7 @@ There isn't a limit on the number of projects that you can create within a proje
 
 ::: moniker range="< azure-devops"
 
-1. Sign in to your DevOps Server collection (```https://<your-devops-server>/<your-organization>```). 
+1. Sign in to your collection (```https://<your-devops-server>/<your-collection>```). 
 
 2. Select **New project**. You can also [create a project from a process](../settings/work/manage-process.md).
 

docs/media/icons/filter-icon.png

@@ -9,19 +9,19 @@ ms.topic: conceptual
 ms.author: chcomley
 author: chcomley
 monikerRange: '>= azure-devops-2019'
-ms.date: 09/13/2024
+ms.date: 03/11/2025
 ---
 
 # Delete a project
 
 [!INCLUDE [version-gt-eq-2019](../../includes/version-gt-eq-2019.md)] 
 
-If a project becomes obsolete, you can [delete it](#delete-project) from your organization or collection in Azure DevOps. Likewise, if you're migrating from an on-premises Azure DevOps Server to Azure DevOps Services, it might be necessary to delete the project. The removal of projects can also enhance navigation by restricting it to only those projects that are currently in use.
+If a project becomes obsolete, you can [delete it](#delete-project) from your organization or collection in Azure DevOps. If you're migrating from an on-premises Azure DevOps Server to Azure DevOps Services, you might also need to delete the project. Removing unused projects can enhance navigation by limiting it to only those projects that are currently in use.
 
 > [!CAUTION]
 > - Soft-deleted projects from the web portal are permanently removed if not restored within 28 days.
 > - In rare cases, our deletion process might take up to 70 days due to backend retries and the need to delete data from multiple sources.
-> - Hard-deleted projects from the on-premises Azure DevOps Administration Console cannot be restored.
+> - Hard-deleted projects from the on-premises Azure DevOps Administration Console can't be restored.
 > For more information, see [Restore a project](#restore-a-deleted-project) and [Save project data](#save-project-data).
 
 ## Prerequisites
@@ -175,7 +175,7 @@ If you inadvertently delete a project in Azure DevOps, you can restore it within
 
 ::: moniker range="azure-devops"
 
-1. Sign in to your organization (```https://dev.azure.com/{yourorganization}```).
+1. Sign in to your organization (```https://dev.azure.com/{Your_Organization}```).
 2. Select ![gear icon](../../media/icons/gear-icon.png) **Organization settings**.
 
    ![Screenshot showing the gear icon, Organization settings.](../../media/settings/open-admin-settings-vert.png)
@@ -207,14 +207,14 @@ If you inadvertently delete a project in Azure DevOps, you can restore it within
 ::: moniker range="azure-devops-2019"
 
 > [!NOTE]
-> The UI doesn't support restoring a team project for Azure DevOps Server 2019.  Use the following REST API or PowerShell methods to restore a deleted team project. For more information, see [Projects-Update REST API](/rest/api/azure/devops/core/projects/update).
+> The UI doesn't support restoring a team project for Azure DevOps Server 2019. Use the following REST API or PowerShell methods to restore a deleted team project. For more information, see [Projects-Update REST API](/rest/api/azure/devops/core/projects/update).
 
 ::: moniker-end
 
 ### Restore project with REST API
 
 > [!WARNING]
-> To restore a project with a name that's already taken, you must rename the project before you can restore it. To rename the project, enter the following text in the request body: `"name":"new name"`
+> To restore a project with an existing name, rename the project first. To rename the project, enter the following text in the request body: `"name":"new name"`.
 
 1. Open a browser window and enter a URL that uses the following form:  
 

docs/organizations/projects/about-projects.md

@@ -11,7 +11,7 @@ metadata:
   ms.topic: landing-page 
   author: chcomley 
   ms.author: chcomley 
-  ms.date: 07/03/2023
+  ms.date: 03/11/2025
 
 # linkListType: architecture | concept | deploy | download | get-started | how-to-guide | learn | overview | quickstart | reference | tutorial | video | whats-new
 
@@ -25,7 +25,7 @@ landingContent:
         links:
           - text: Navigate the web portal 
             url: ./navigation/index.md
-          - text: Get started with Search
+          - text: Search Azure DevOps
             url: ./search/get-started-search.md
       - linkListType: how-to-guide
         links:
@@ -37,7 +37,7 @@ landingContent:
             url: ../organizations/settings/set-your-preferences.md?toc=/azure/devops/project/toc.json
           - text: Connect to a project
             url: ../organizations/projects/connect-to-projects.md?toc=/azure/devops/project/toc.json
-  - title: Add and manage wikis
+  - title: Manage wikis
     linkLists:
       - linkListType: overview
         links:
@@ -65,7 +65,7 @@ landingContent:
     linkLists:
       - linkListType: overview
         links:
-          - text: Search across all your code, wiki, packages and work items
+          - text: Search across all your code, wiki, packages, and work items
             url: ./search/get-started-search.md
       - linkListType: how-to-guide
         links:

docs/organizations/projects/create-project.md

@@ -8,16 +8,15 @@ ms.author: chcomley
 author: chcomley
 ms.topic: how-to
 monikerRange: '<= azure-devops'
-ms.date: 04/04/2022
+ms.date: 03/11/2025
 ---
-  
 
 
 # Filter lists, boards, and directories 
 
 [!INCLUDE [version-lt-eq-azure-devops](../../includes/version-lt-eq-azure-devops.md)] 
 
-Several applications and pages in Azure DevOps support filtering, which is particularly useful when dealing with a large number of artifacts or items. Most directory views offer one or more filter functions to help you quickly find what you're looking for.
+Several applications and pages in Azure DevOps support filtering, which is useful when dealing with a large number of artifacts or items. Most directory views offer one or more filter functions to help you quickly find what you're looking for.
 
 You can filter most items using keywords or a user name, either for the author of an item or where work is assigned to them. Filtering can be applied to lists and boards in the following areas:
 
@@ -30,28 +29,26 @@ You can filter most items using keywords or a user name, either for the author o
 
 ## Prerequisites
 
-- **Access**: 
-  - Member of the project where you want to apply filters. If you don't have access, request it from your project administrator.
-  - At least **Basic** access to use filtering features. Users with Stakeholder access may have limited filtering capabilities.
-- **Permissions**: Necessary permissions to view and interact with the items that you want to filter. This typically includes being a member of the Contributors group or having similar permissions.
+| Category | Requirements |
+|--------------|-------------|
+|**Permissions**|Member of the **Contributors** group or similar permissions. |
+|**Access**| - Member of the project where you want to apply filters. If you don't have access, request it from your project administrator.</br>- At least **Basic** access to use filtering features. Users with Stakeholder access might experience limited filtering capabilities.|
 
 <a id="filter"></a>
 
 ## Filter based on keywords, tags, or fields
 
 To turn on filtering, choose the :::image type="icon" source="../../media/icons/filter-icon.png" border="false"::: filter icon. 
 
-You can filter work items by entering a keyword or using one or more of the fields provided, such as work item type, assigned to, state, and tags. Based on the keyword that you enter, the filter function lists work items based on any visible/displayed column or field, including tags. Also, you can enter a value for an ID, whether or not the ID field is visible.  
+You can filter work items by entering a keyword or using fields like work item type, assigned to, state, and tags. The filter lists work items based on any visible column or field, including tags. You can also enter an ID value, regardless of the visibility of the ID field.
 
-![Backlogs, turn filtering on](../../boards/backlogs/media/filter-backlogs-options.png)
+![Screenshot showing Backlogs and highlighted filter icon.](../../boards/backlogs/media/filter-backlogs-options.png)
 
 The filtered set is always a flat list, even if you selected to show parents. 
 
 ### Characters ignored by keyword filter criteria
 
-The filter criteria ignore the following characters: `,` (comma), `.` (period), `/` (forward slash), and `\` (back slash). 
-
-::: moniker range=">= azure-devops-2019"
+The filter criteria ignore the following characters: `,` (comma), `.` (period), `/` (forward slash), and `\` (back slash).
 
 ## Filter directories
 
@@ -60,9 +57,7 @@ Choose the :::image type="icon" source="../../media/icons/filter-icon.png" borde
 For example, here we turn on filtering for the dashboard directory. 
 
 > [!div class="mx-imgBorder"]  
-> ![Filter the dashboard directory](../../report/dashboards/media/dashboards/filter-directory.png)   
-
-::: moniker-end
+> ![Screenshot shows highlighted Filter icon in the dashboard directory.](../../report/dashboards/media/dashboards/filter-directory.png)   
 
 ## Related articles  
 - [Commit history](../../repos/git/commit-history.md)

docs/organizations/projects/delete-project.md

@@ -8,69 +8,50 @@ ms.author: chcomley
 author: chcomley
 ms.topic: overview
 monikerRange: '<= azure-devops'
-ms.date: 01/08/2024
+ms.date: 03/11/2025
 ---
 
-# Navigate the web portal in Azure DevOps  
+# Navigate the Azure DevOps web portal
 
 [!INCLUDE [version-lt-eq-azure-devops](../../includes/version-lt-eq-azure-devops.md)] 
 
 ::: moniker range="azure-devops"
 
-The web portal for Azure DevOps is organized around a set of services and administrative pages and several task specific features, such as the search box. The service labels differ depending on whether you work from Azure DevOps Services or Azure DevOps on premises and its version. 
+The Azure DevOps web portal is organized into various services, administrative pages, and task-specific features like the search box. Service labels vary depending on whether you’re using Azure DevOps Services or an on-premises version.
 
 [!INCLUDE [temp](../../includes/version-selector.md)] 
 
-Each service provides you with one or more pages, which support many features and functional tasks. Within a page, you might then have a choice of options to select a specific artifact or add an artifact.
+Each service offers multiple pages with numerous features and functional tasks. Within each page, you can choose options to select or add specific artifacts.
 
 ::: moniker-end
 
 ::: moniker range="azure-devops-2019"
 
-The web portal for Azure DevOps Server is organized around a set of services&mdash;such as, **Overview**, **Boards**, **Repos**, **Pipelines**, **Test Plans**, and **Artifacts—as well as administrative pages and several task-specific features such as the search box. Each service provides you with one or more pages that support many features and functional tasks. Within a page, you might then have a choice of options to select a specific artifact or add an artifact. 
-
-Each service provides you with one or more pages that support many features and functional tasks. Within a page, you might then have a choice of options to select a specific artifact or add an artifact.
-
-::: moniker-end
-
-
-
-
-Here's what you need to know to get up and running using the web portal.  
-
-::: moniker range=">= azure-devops-2019"
-- [**Open a service, page, or settings**](go-to-service-page.md): use to switch to a different [service or functional area](../../user-guide/services.md) 
-- [**Add an artifact or team**](add-artifact-team.md): use to quickly add a work item, Git repo, build or release pipelines, or a new team
-- [**Open another project or repo**](work-across-projects.md): use to switch to a different project or access work items and pull requests defined in different projects, or your favorite items
-- [**Open team artifacts, use breadcrumbs, selectors and directories**](use-breadcrumbs-selectors.md): use to navigate within a service, to open other artifacts, or return to a root function
-- [**Work with favorites**](set-favorites.md): favorite artifacts to support quick navigation  
-- [**Search box**](../search/get-started-search.md): use to find code, work items, or wiki content  
-- [**Your profile menu**](../../organizations/settings/set-your-preferences.md?toc=/azure/devops/project/navigation/toc.json&bc=/azure/devops/project/navigation/breadcrumb/toc.json): use to set personal preferences, notifications, and enable preview features  
-- [**Settings**](../../organizations/settings/about-settings.md#project-administrator-role-and-managing-projects): use to add teams, manage security, and configure other project and organization level resources.  
+The Azure DevOps Server web portal is organized into several services, including **Overview**, **Boards**, **Repos**, **Pipelines**, **Test Plans**, and **Artifacts**. It also includes administrative pages and task-specific features like the search box. Each service offers multiple pages with various features and functional tasks. Within each page, you can choose options to select or add specific artifacts.
 
 ::: moniker-end
 
+## Key features and navigation
 
+Here's what you need to know to start using the web portal effectively.  
 
+- [**Open a service, page, or settings**](go-to-service-page.md): Use to switch to a different [service or functional area](../../user-guide/services.md) 
+- [**Add an artifact or team**](add-artifact-team.md): Use to quickly add a work item, Git repo, build or release pipelines, or a new team
+- [**Open another project or repo**](work-across-projects.md): Use to switch to a different project or access work items and pull requests defined in different projects, or your favorite items
+- [**Open team artifacts, use breadcrumbs, selectors and directories**](use-breadcrumbs-selectors.md): Use to navigate within a service, open other artifacts, or return to a root function
+- [**Work with favorites**](set-favorites.md): Mark your favorite artifacts for quick navigation  
+- [**Search box**](../search/get-started-search.md): Use to find code, work items, or wiki content  
+- [**Your profile menu**](../../organizations/settings/set-your-preferences.md?toc=/azure/devops/project/navigation/toc.json&bc=/azure/devops/project/navigation/breadcrumb/toc.json): Use to set personal preferences, notifications, and enable preview features  
+- [**Settings**](../../organizations/settings/about-settings.md#project-administrator-role-and-managing-projects): Use to add teams, manage security, and configure other project and organization level resources.  
 
-::: moniker range=">= azure-devops-2019" 
 > [!NOTE]  
-> Only those services that are enabled will appear in the user interface. For example, if **Boards** is disabled, then **Boards** or **Work** and all pages associated with that service won't appear. To enable or disable a service, see [Turn an Azure DevOps service on or off](../../organizations/settings/set-services.md).
-::: moniker-end
-
-
-::: moniker range=">= azure-devops-2019"  
-You select services—such as **Boards**, **Repos**, and **Pipelines**—from the sidebar and pages within those services. 
-
-![Vertical sidebar](media/gif-images/vertical-nav.gif)
-
-::: moniker-end
-
-
+> Only enabled services are visible in the user interface. For example, if **Boards** is disabled, then **Boards** or **Work** and all pages associated with that service don't appear. To enable or disable a service, see [Turn an Azure DevOps service on or off](../../organizations/settings/set-services.md).
 
+Select services—such as **Boards**, **Repos**, and **Pipelines**—from the sidebar and pages within those services. 
 
+![Screenshot shows vertical sidebar.](media/gif-images/vertical-nav.gif)
 
-Now that you have an understanding of how the user interface is structured, it's time to get started using it. As you can see, there are numerous features and functionality.  
+Now that you understand the user interface structure, it’s time to start using it. You can find a wide range of features and functionalities to explore.
 
 If all you need is a code repository and bug tracking solution, then start with [Get started with Git](../../repos/git/gitquickstart.md) and [Manage bugs](../../boards/backlogs/manage-bugs.md).  
 
@@ -138,8 +119,8 @@ Although you can access source code, work items, and builds from both clients, s
 
 [!INCLUDE [temp](../../repos/git/includes/note-new-git-tool.md)]
 
-## Resources  
+## Related articles
 
 - [Manage projects](../../organizations/projects/about-projects.md) 
-- [Project & organization settings](../../organizations/settings/about-settings.md#project-administrator-role-and-managing-projects) 
+- [Manage settings for projects and organizations](../../organizations/settings/about-settings.md#project-administrator-role-and-managing-projects)