Skip to content

Commit df98ed5

Browse files
committed
Learn Editor: Update create-project.md
1 parent 271089f commit df98ed5

File tree

1 file changed

+55
-67
lines changed

1 file changed

+55
-67
lines changed

docs/organizations/projects/create-project.md

+55-67
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,4 @@
11
---
2-
title: Create a project
3-
titleSuffix: Azure DevOps
4-
ms.custom: devx-track-azurecli, engagement-fy23
5-
description: Learn how to create a new project where your team can plan, track progress, and collaborate on building software solutions.
6-
ms.assetid: 21F3C364-34F4-41B0-9EFC-6D4A141D81E0
7-
ms.subservice: azure-devops-projects
8-
ms.topic: how-to
9-
ms.author: chcomley
10-
author: chcomley
11-
monikerRange: '>= azure-devops-2019'
12-
ms.date: 11/11/2024
13-
---
14-
15-
162
# Create a project in Azure DevOps
173

184
[!INCLUDE [version-gt-eq-2019](../../includes/version-gt-eq-2019.md)]
@@ -71,30 +57,30 @@ There isn't a limit on the number of projects that you can create within a proje
7157

7258
1. Sign in to your organization (```https://dev.azure.com/{Your_Organization}```).
7359

74-
1. Select **New project**.
60+
2. Select **New project**.
7561

76-
> [!div class="mx-imgBorder"]
77-
> ![Screenshot of listed projects and highlighted New projects button.](media/create-project/select-new-project.png)
78-
79-
1. Enter information into the form provided.
80-
- Provide a name for your project. Your project name can't contain special characters, such as `/ : \ ~ & % ; @ ' " ? < > | # $ * } { , + = [ ]`, can't begin with an underscore, can't begin or end with a period, and must be 64 or fewer characters.
81-
- Enter an optional description.
82-
- Choose the visibility, initial source control type, and work item process.
83-
For more information, see [Choosing the right version control for your project](../../repos/tfvc/comparison-git-tfvc.md) and [Choose a process](../../boards/work-items/guidance/choose-process.md).
84-
85-
```
86-
> [!div class="mx-imgBorder"]
87-
```
88-
> ![Screenshot of create new project form.](media/create-project/create-new-project-form-new-nav-2.png)
89-
90-
```
91-
When you choose public visibility, anyone on the internet can view your project. With private visibility, only users you give access to can view your project. For more information about features and access levels for public projects, see [Make a private project public](make-project-public.md). If the **Public** option isn't available, you need to change the policy.
92-
```1. Select **Create**. Azure DevOps displays the project welcome page.
62+
> [!div class="mx-imgBorder"]
63+
> ![Screenshot of listed projects and highlighted New projects button.](media/create-project/select-new-project.png)
9364

94-
> [!div class="mx-imgBorder"]
95-
```
96-
Select one of the following options to continue:
97-
```- **Invite**: Add others to your project. See [Add users to a project or team](../security/add-users-team-project.md). You can only invite users who are already in your organization. For more information, see [Add users to a project](../security/add-users-team-project.md#add-users-to-a-project).
65+
3. Enter information into the form provided.
66+
- Provide a name for your project. Your project name can't contain special characters, such as `/ : \ ~ & % ; @ ' " ? < > | # $ * } { , + = [ ]`, can't begin with an underscore, can't begin or end with a period, and must be 64 or fewer characters.
67+
- Enter an optional description.
68+
- Choose the visibility, initial source control type, and work item process.
69+
For more information, see [Choosing the right version control for your project](../../repos/tfvc/comparison-git-tfvc.md) and [Choose a process](../../boards/work-items/guidance/choose-process.md).
70+
71+
> [!div class="mx-imgBorder"]
72+
> ![Screenshot of create new project form.](media/create-project/create-new-project-form-new-nav-2.png)
73+
74+
When you choose public visibility, anyone on the internet can view your project. With private visibility, only users you give access to can view your project. For more information about features and access levels for public projects, see [Make a private project public](make-project-public.md). If the **Public** option isn't available, you need to change the policy.
75+
76+
4. Select **Create**. Azure DevOps displays the project welcome page.
77+
78+
> [!div class="mx-imgBorder"]
79+
> ![Screenshot of project creation confirmation dialog.](media/create-project/project-creation-complete-preview.png)
80+
81+
Select one of the following options to continue:
82+
83+
- **Invite**: Add others to your project. See [Add users to a project or team](../security/add-users-team-project.md). You can only invite users who are already in your organization. For more information, see [Add users to a project](../security/add-users-team-project.md#add-users-to-a-project).
9884
- **Boards**: Add work items. See [View and add work items using the Work Items page](../../boards/work-items/view-add-work-items.md).
9985
- **Repos**: Clone or import a repository or initialize a *README* file for your project summary page. See [Clone an existing Git repo](../../repos/git/clone.md).
10086
- **Pipelines**: Define a pipeline. See [Azure Pipelines documentation](../../pipelines/index.yml).
@@ -108,27 +94,30 @@ For more information, see [Choosing the right version control for your project](
10894

10995
1. Sign in to your DevOps Server collection (```https://<your-devops-server>/<your-organization>```).
11096

111-
1. Select **New project**. You can also [create a project from a process](../settings/work/manage-process.md).
97+
2. Select **New project**. You can also [create a project from a process](../settings/work/manage-process.md).
11298

113-
> [!div class="mx-imgBorder"]
114-
1. Enter information into the form provided.
115-
- Provide a name for your project. Your project name can't contain special characters, such as `/ : \ ~ & % ; @ ' " ? < > | # $ * } { , + = [ ]`, can't begin with an underscore, can't begin or end with a period, and must be 64 or fewer characters.
116-
- Enter an optional description.
117-
- Choose the visibility, initial source control type, and work item process.
118-
For more information, see [Choosing the right version control for your project](../../repos/tfvc/comparison-git-tfvc.md) and [About processes and process templates](../../boards/work-items/guidance/choose-process.md).
99+
> [!div class="mx-imgBorder"]
100+
> ![Screenshot of listed projects and highlighted New projects button.](media/create-project/select-new-project.png)
119101

102+
3. Enter information into the form provided.
103+
- Provide a name for your project. Your project name can't contain special characters, such as `/ : \ ~ & % ; @ ' " ? < > | # $ * } { , + = [ ]`, can't begin with an underscore, can't begin or end with a period, and must be 64 or fewer characters.
104+
- Enter an optional description.
105+
- Choose the visibility, initial source control type, and work item process.
106+
For more information, see [Choosing the right version control for your project](../../repos/tfvc/comparison-git-tfvc.md) and [About processes and process templates](../../boards/work-items/guidance/choose-process.md).
120107

121-
> [!div class="mx-imgBorder"]
122-
> ![Screenshot of create new project form.](media/create-project/create-new-project-form-new-nav-2.png)
123-
108+
> [!div class="mx-imgBorder"]
109+
> ![Screenshot of create new project form.](media/create-project/create-new-project-form-new-nav-2.png)
124110

125-
When you choose public visibility, anyone on the internet can view your project. With private visibility, only people who you give access to can view your project. For more information about public projects, see [Create a public project in your organization](../projects/create-project.md). If the **Public** option isn't available, you need to change the policy.
126-
```1. Select **Create**. Azure DevOps displays the welcome page.
111+
When you choose public visibility, anyone on the internet can view your project. With private visibility, only people who you give access to can view your project. For more information about public projects, see [Create a public project in your organization](../projects/create-project.md). If the **Public** option isn't available, you need to change the policy.
127112

128-
> [!div class="mx-imgBorder"]
129-
Select one of the following options to continue:
113+
4. Select **Create**. Azure DevOps displays the welcome page.
130114

131-
- **Invite**: add others to your project. See [Add users to a project or team](../security/add-users-team-project.md). You can only invite users who are already in your organization. For more information, see [Add users to a project](../security/add-users-team-project.md#add-users-to-a-project).
115+
> [!div class="mx-imgBorder"]
116+
> ![Screenshot of project creation confirmation dialog.](media/create-project/project-creation-complete-new-nav.png)
117+
118+
Select one of the following options to continue:
119+
120+
- **Invite**: add others to your project. See [Add users to a project or team](../security/add-users-team-project.md). You can only invite users who are already in your organization. For more information, see [Add users to a project](../security/add-users-team-project.md#add-users-to-a-project).
132121
- **Boards**: add work items. See [View and add work items using the Work Items page](../../boards/work-items/view-add-work-items.md).
133122
- **Repos**: clone or import a repository, or initialize a *README* file for your project summary page. See [Clone an existing Git repo](../../repos/git/clone.md).
134123
- **Pipelines**: define a pipeline. See [Azure Pipelines documentation](../../pipelines/index.yml).
@@ -200,34 +189,34 @@ View a list of projects from your web browser.
200189

201190
1. Sign in to your organization (```https://dev.azure.com/{yourorganization}```).
202191

203-
1. Select **Organization settings** and then select **Projects**.
192+
2. Select **Organization settings** and then select **Projects**.
204193

205-
> [!div class="mx-imgBorder"]
206-
> ![Screenshot of highlighted Project button and resulting list.](media/create-project/list-projects-org-settings.png)
194+
> [!div class="mx-imgBorder"]
195+
> ![Screenshot of highlighted Project button and resulting list.](media/create-project/list-projects-org-settings.png)
207196

208-
```
209-
Open your desired project. For more information, see [About settings at the user, team, project, or organization-level](../settings/about-settings.md).
210-
```::: moniker-end
197+
Open your desired project. For more information, see [About settings at the user, team, project, or organization-level](../settings/about-settings.md).
198+
199+
::: moniker-end
211200

212201
::: moniker range=" azure-devops-2019"
213202

214203
1. To view the projects defined for a collection, select ![Azure DevOps logo](../../media/icons/project-icon.png) **Azure DevOps** to open the **Projects** page.
215204

216-
1. Choose the collection to view the list of projects. The page lists the last two or three projects you connected to at the upper screen. Choose any project to connect to that project.
205+
2. Choose the collection to view the list of projects. The page lists the last two or three projects you connected to at the upper screen. Choose any project to connect to that project.
217206

218-
> [!div class="mx-imgBorder"]
219-
> ![Screenshot of projects list.](media/create-project/list-projects-2019.png)
207+
> [!div class="mx-imgBorder"]
208+
> ![Screenshot of projects list.](media/create-project/list-projects-2019.png)
220209

221210
Or
222211

223212
- Select **Admin settings** and then choose **Projects** to list all projects.
224213

225-
> [!div class="mx-imgBorder"]
226-
> ![Screenshot of selected Admin settings and Projects.](media/create-project/list-projects-admin-settings-2019.png)
214+
> [!div class="mx-imgBorder"]
215+
> ![Screenshot of selected Admin settings and Projects.](media/create-project/list-projects-admin-settings-2019.png)
227216

228-
```
229-
You can choose a project to open project settings for that project on this page. For more information, see [About settings at the user, team, project, or organization-level](../settings/about-settings.md). Or, you can [rename a project](rename-project.md) or [delete a project](delete-project.md).
230-
```::: moniker-end
217+
You can choose a project to open project settings for that project on this page. For more information, see [About settings at the user, team, project, or organization-level](../settings/about-settings.md). Or, you can [rename a project](rename-project.md) or [delete a project](delete-project.md).
218+
219+
::: moniker-end
231220

232221
#### [Team Explorer](#tab/team-explorer)
233222

@@ -343,7 +332,6 @@ You can add Git (distributed) or TFVC (centralized) repositories to your project
343332
- [Rename a project](rename-project.md)
344333
- [Delete a project](delete-project.md)
345334
- [Get started as an administrator](../../user-guide/project-admin-tutorial.md)
346-
347335
- [Install extensions](../../marketplace/install-extension.md)
348336

349337
## Frequently asked questions (FAQs)
@@ -379,4 +367,4 @@ The log shows each action taken by the wizard at the time of the failure and mig
379367
### Q: How do I add SQL Server Reporting services?
380368

381369
A: See [Add reports to a project](/previous-versions/azure/devops/report/admin/add-reports-to-a-team-project).
382-
::: moniker-end
370+
::: moniker-end

0 commit comments

Comments
 (0)