diff --git a/docs/project/wiki/media/project-home-page-activity.png b/docs/organizations/projects/media/share-project/project-home-page-activity.png similarity index 100% rename from docs/project/wiki/media/project-home-page-activity.png rename to docs/organizations/projects/media/share-project/project-home-page-activity.png diff --git a/docs/organizations/projects/media/summary/about-this-project-dialog.png b/docs/organizations/projects/media/summary/about-this-project-dialog.png new file mode 100644 index 00000000000..cfc6baae9cf Binary files /dev/null and b/docs/organizations/projects/media/summary/about-this-project-dialog.png differ diff --git a/docs/organizations/projects/media/summary/add-project-description.png b/docs/organizations/projects/media/summary/add-project-description.png new file mode 100644 index 00000000000..338b7865d02 Binary files /dev/null and b/docs/organizations/projects/media/summary/add-project-description.png differ diff --git a/docs/organizations/projects/media/summary/connect-with-team-member.png b/docs/organizations/projects/media/summary/connect-with-team-member.png new file mode 100644 index 00000000000..e86fa359d20 Binary files /dev/null and b/docs/organizations/projects/media/summary/connect-with-team-member.png differ diff --git a/docs/organizations/projects/media/summary/invite-members-tfs-2018.png b/docs/organizations/projects/media/summary/invite-members-tfs-2018.png new file mode 100644 index 00000000000..d56bcdd1043 Binary files /dev/null and b/docs/organizations/projects/media/summary/invite-members-tfs-2018.png differ diff --git a/docs/organizations/projects/media/summary/invite-users.png b/docs/organizations/projects/media/summary/invite-users.png new file mode 100644 index 00000000000..0667f46879a Binary files /dev/null and b/docs/organizations/projects/media/summary/invite-users.png differ diff --git a/docs/organizations/projects/media/summary/project-members.png b/docs/organizations/projects/media/summary/project-members.png new file mode 100644 index 00000000000..d90b6206555 Binary files /dev/null and b/docs/organizations/projects/media/summary/project-members.png differ diff --git a/docs/organizations/projects/media/summary/project-search.png b/docs/organizations/projects/media/summary/project-search.png new file mode 100644 index 00000000000..7fb13ff256e Binary files /dev/null and b/docs/organizations/projects/media/summary/project-search.png differ diff --git a/docs/organizations/projects/media/summary/project-stats.png b/docs/organizations/projects/media/summary/project-stats.png new file mode 100644 index 00000000000..97d70cfa108 Binary files /dev/null and b/docs/organizations/projects/media/summary/project-stats.png differ diff --git a/docs/organizations/projects/media/summary/project-summary-activity-tfs-2018.png b/docs/organizations/projects/media/summary/project-summary-activity-tfs-2018.png new file mode 100644 index 00000000000..f810a7d09d5 Binary files /dev/null and b/docs/organizations/projects/media/summary/project-summary-activity-tfs-2018.png differ diff --git a/docs/organizations/projects/media/summary/project-summary-page-intro-tfs-2018.png b/docs/organizations/projects/media/summary/project-summary-page-intro-tfs-2018.png new file mode 100644 index 00000000000..d90968f6fd2 Binary files /dev/null and b/docs/organizations/projects/media/summary/project-summary-page-intro-tfs-2018.png differ diff --git a/docs/organizations/projects/media/summary/project-summary-page-intro.png b/docs/organizations/projects/media/summary/project-summary-page-intro.png new file mode 100644 index 00000000000..7655caab83b Binary files /dev/null and b/docs/organizations/projects/media/summary/project-summary-page-intro.png differ diff --git a/docs/organizations/projects/media/summary/select-readme-repository.png b/docs/organizations/projects/media/summary/select-readme-repository.png new file mode 100644 index 00000000000..a5f8933e7c2 Binary files /dev/null and b/docs/organizations/projects/media/summary/select-readme-repository.png differ diff --git a/docs/organizations/projects/project-team-quick-reference.md b/docs/organizations/projects/project-team-quick-reference.md index 812dcf2ccd0..deaabd4702b 100644 --- a/docs/organizations/projects/project-team-quick-reference.md +++ b/docs/organizations/projects/project-team-quick-reference.md @@ -146,6 +146,7 @@ Several of the following tasks require permissions granted to a member of the Pr - [Connect to GitHub](../../boards/github/connect-to-github.md) - [Create project](create-project.md) - [Delete project](delete-project.md) +- [Edit project Summary](project-vision-status.md) - [Enable/disable project services](../settings/set-services.md) - [Export list of projects](create-project.md#list-and-connect-to-projects) - [Export list of teams](../settings/add-teams.md#list-teams) @@ -191,6 +192,7 @@ Several of the following tasks require permissions granted to a member of the Pr :::column span=""::: - [Create project](create-project.md) - [Delete project](delete-project.md) +- [Edit project Summary](project-vision-status.md) - [Enable/disable project services](../settings/set-services.md) - [Manage notifications](../../notifications/manage-team-group-global-organization-notifications.md) - [Manage your project](../../user-guide/project-admin-tutorial.md) @@ -230,6 +232,7 @@ Several of the following tasks require permissions granted to a member of the Pr - [Connect to a project](connect-to-projects.md) - [Create project](create-project.md) - [Delete project](delete-project.md) +- [Edit project Summary](project-vision-status.md) - [Manage notifications](../../notifications/manage-team-group-global-organization-notifications.md) - [Manage your project](../../user-guide/project-admin-tutorial.md) - [Navigate the Web portal](../../project/navigation/index.md) diff --git a/docs/organizations/projects/project-vision-status.md b/docs/organizations/projects/project-vision-status.md index ec820735ab0..776c5676af6 100644 --- a/docs/organizations/projects/project-vision-status.md +++ b/docs/organizations/projects/project-vision-status.md @@ -1,48 +1,120 @@ --- -title: Share your project vision & view project activity +title: Project Summary, vision, & view project activity titleSuffix: Azure DevOps -description: View or update your project home page to share project vision, objectives, and activity for Azure DevOps +description: View or update your project Summary to share project vision, objectives, and activity for Azure DevOps ms.topic: quickstart ms.technology: devops-collab ms.assetid: A9ED2BF5-BD0B-4114-A7BD-693C5D747E16 ms.author: chcomley author: chcomley -monikerRange: '>= tfs-2015' -ms.date: 03/26/2019 +monikerRange: '>= tfs-2017' +ms.date: 08/24/2021 --- # Share your project vision, view project activity -[!INCLUDE [temp](../../includes/version-ts-tfs-2015-2016.md)] +[!INCLUDE [temp](../../includes/version-tfs-2017-through-vsts.md)] -::: moniker range=">= azure-devops-2019" -Learn how to share your project with your team, add project members, and check the latest project activity. Share your project and objective, and ways for team members to contribute to the project through a project README file or through a project wiki. +::: moniker range="> tfs-2017" +Each project provides a **Summary** or home page to share information and showcase the latest project activity. Use this page to perform one or more of the following tasks. +::: moniker-end +::: moniker range="tfs-2017" +Each project provides a **Summary** or home page to share information and showcase the latest project activity. +> [!NOTE] +> The project **Home** page is available for TFS 2017.1 and later versions. It replaces the Welcome page used in TFS 2015 and TFS 2017. -If you want to use a project wiki, then first [create a Wiki for your project](../../project/wiki/wiki-create-repo.md). You can then [change the project summary page to point to the wiki](#change-repo). +Use this page to perform one or more of the following tasks. ::: moniker-end -::: moniker range="tfs-2015" -From the project home page, share your project with your team, add project members, and check the latest project activity. Share your project and objective, and ways for team members to contribute to the project through a project README file. +:::row::: + :::column span="1"::: + **Project Administrator tasks** + :::column-end::: + :::column span="1"::: + **Project member tasks** + :::column-end::: +:::row-end::: +:::row::: + :::column span="1"::: + ::: moniker range=">= azure-devops-2019" + - Add a short project description + - Choose a README file or wiki for project information + - Invite people to contribute to your project + - Set project tags + ::: moniker-end + ::: moniker range="tfs-2018" + - Choose a README file or wiki for project information + - Invite people to contribute to your project + ::: moniker-end + ::: moniker range="tfs-2017" + - Choose a README file for project information + - Invite people to contribute to your project + ::: moniker-end + :::column-end::: + :::column span="1"::: + ::: moniker range=">= azure-devops-2019" + - View project information + - View project activity + - Favorite a project + - Email or initiate a chat with a team member + - Initiate a search across your project + ::: moniker-end + ::: moniker range="<= tfs-2018" + - View project information + - Email or initiate a chat with a team member + - View project activity + ::: moniker-end + :::column-end::: +:::row-end::: + +::: moniker range="azure-devops" +> [!NOTE] +> Hosted projects can be designated as **Private** or **Public**. For public projects, anonymous users can view the project **Summary**, except for the **Members** section. Also the **Like** and **Favorite** icons aren't visible to anonymous users. To learn more about public projects, see [What is a public project?](../public/about-public-projects.md) ::: moniker-end -::: moniker range=">= azure-devops-2019" -> [!NOTE] -> The features and functions available from your project page depend on the source control, Git, or Team Foundation Version Control (TFVC) that you selected when you [created your team project](../../organizations/projects/create-project.md). +::: moniker range=">= azure-devops-2019" +:::image type="content" source="media/summary/project-summary-page-intro.png" alt-text="Screenshot of summary page."::: +::: moniker-end +::: moniker range="< azure-devops-2019" +:::image type="content" source="media/summary/project-summary-page-intro-tfs-2018.png" alt-text="Screenshot of summary page, TFS-2018."::: ::: moniker-end +::: moniker range=">= tfs-2018" +> [!NOTE] +> If you want to use a project wiki for your project Summary information, then first [create a Wiki for your project](../../project/wiki/wiki-create-repo.md). You can then [change the project summary page to point to the wiki](#update). +::: moniker-end + + + ## Prerequisites +::: moniker range=">= tfs-2018" - You must be a member of the [Project Administrators group](../../organizations/security/set-project-collection-level-permissions.md) or have your **Edit project-level information** permission set to **Allow** to do the following: - Edit information on the project page - - Change the repository that you use to share your project mission + - Change the repository that you use to share project information - Manage project membership - To edit a page, you must be a contributor to the repository or branch or have the **Contribute** permissions set to **Allow**. -- To view the project page, you must be a valid member of the project. For more information, see [About security, membership, and permissions; Valid user groups](../../organizations/security/about-permissions.md#validusers). +- To view the project **Summary**, you must be a valid member of the project. For more information, see [About security, membership, and permissions; Valid user groups](../../organizations/security/about-permissions.md#validusers). +- To add or edit project **Tags**, you must have the project-level **Manage properties** permission set to **Allow**. This permission controls the project properties REST API. The project properties REST API is used to drive the project tags experience in the product. +::: moniker-end -## Open project summary + +::: moniker range="< tfs-2018" +- You must be a member of the [Project Administrators group](../../organizations/security/set-project-collection-level-permissions.md) or have your **Edit project-level information** permission set to **Allow** to do the following: + - Edit information on the project page + - Change the repository that you use to share project information + - Manage project membership +- To edit a page, you must be a contributor to the repository or branch or have the **Contribute** permissions set to **Allow**. +- To view the project **Summary**, you must be a valid member of the project. For more information, see [About security, membership, and permissions; Valid user groups](../../organizations/security/about-permissions.md#validusers). +::: moniker-end + +> [!TIP] +> If you don't have permissions to edit a page or use a feature, the corresponding icons and links aren't visible. ::: moniker range=">= azure-devops-2019" -From your web browser, choose **Overview** > **Summary**. If you don't have a project yet, [create a project](../../organizations/projects/create-project.md). +## Open project Summary + +From your web browser, choose **Overview>Summary**. If you don't have a project yet, [create a project](../../organizations/projects/create-project.md). If you haven't set up your project summary yet, you'll see this welcome page: @@ -58,22 +130,131 @@ Select one of the following tasks to get started: - **Test Plans** to start [defining test plans and test suites](../../test/create-a-test-plan.md). - [Manage your services](../../organizations/settings/set-services.md) to disable the visibility of one or more services. -To support your project mission, choose a README file that you maintain in a project repository, or the [project Wiki](../../project/wiki/wiki-create-repo.md). To choose between a README file or a Wiki, see [Change the repository](#change-repo). To define a README file for your project, see [Initialize a README file for your Git repo](#initialize-git) or [Initialize a README file for your TFVC repo](#initialize-tfvc). ::: moniker-end -::: moniker range=">= tfs-2015 <= tfs-2018 || azure-devops" +::: moniker range="< azure-devops-2019" + +## Open project Home page From your web browser, open the team project drop down menu and select the home page. If you don't have a project, [create a team project](../../organizations/projects/create-project.md). -![Open Project Summary ](media/share-project/project-vision-status-project-home-page.png) +![Open Project Summary](media/share-project/project-vision-status-project-home-page.png) To define a README file for your project, see [Initialize a README file for your Git repo](#initialize-git) or [Initialize a README file for your TFVC repo](#initialize-tfvc). ::: moniker-end -::: moniker range="tfs-2017" + +::: moniker range=">= tfs-2018" + + + +## Update the page + +The **Summary** page displays either the **README** file defined in a project repository or the home page of a project wiki. If you want to use the project wiki home page, first set that up as described in [Create a Wiki for your project](../../project/wiki/wiki-create-repo.md). + +1. To edit the page: + + - If it is the first time editing the page, choose **Add Project Description**. + :::image type="content" source="media/summary/add-project-description.png" alt-text="Screenshot of summary page, first time editing."::: + + - If editing the page after it's been set up, choose the :::image type="icon" source="../../media/icons/edit.png" border="false"::: **Edit project information**. This icon is only visible to members with permissions to edit the project **Summary** page. + +1. Provide a brief description of the project purpose in the **Description** box. + + :::image type="content" source="media/summary/about-this-project-dialog.png" alt-text="About this project dialog."::: + +1. Optionally add one or more **Tags** for your project. These tags are similar to [work item tags](../../boards/queries/add-tags-to-work-items.md). You can add several tags at a time by using the comma or semicolon delimiters. Tags must conform to the following rules: + - Tags must be 40 characters or less + - Tags can;t contain the forward slash (/) character or end with hyphen character (-) + - No more than 15 tags can be added to a project + - Tags are case-insensitive and no duplicate tags or empty tags are allowed. + > [!NOTE] + > The search and filter functions can't be used to search or filter on project tags. + +1. Choose whether to reference a **README** file or the project wiki home page for the rest of the Summary page contents. + + > [!TIP] + > A default README is created within the repository added when you created your project. You can choose this README or create another repository and README file for this purpose. + + If choosing a **Readme file**, select the repository for the README. A preview of the current text for the README file is shown. + + :::image type="content" source="media/summary/select-readme-repository.png" alt-text="About this project dialog, choose and select README repository."::: + + If choosing **Wiki**, note that the Wiki home page is referenced and must be the first file within the Wiki TOC. You can't change that reference. + +1. To update the contents of the referenced README file or wiki, edit the corresponding file. For more information, see [Create a README for your repo](../../repos/git/create-a-readme.md) or [Add and edit wiki pages](../../project/wiki/add-edit-wiki.md). + + Consider including the following types of information in your **Summary** page: + - Ways in which users can contribute to your project + - Who to contact to elevate permissions or add extensions + - Roadmap information + - Links to instructions for setting up their development and test environments + - Links to instructions for collaborating on code, tracking work, building pipelines, deploying releases + - Links to templates to file a bug, issue, or request + - Links to distribution lists to email a question or post a question on Slack or Teams channel. +::: moniker-end + + +## Invite people to contribute to your project + +::: moniker range=">= azure-devops-2019" +You can send an email to invite users to contribute to your project by choosing **Invite**. To learn more, see [Add users or groups to a team or project, Invite users from the Summary page](../security/add-users-team-project.md#invite-users-from-the-summary-page). + +:::image type="content" source="../security/media/add-users/summary-invite-users.png" alt-text="Screenshot of Summary page, Invite button."::: + +::: moniker-end + +::: moniker range="<= tfs-2018" + +To add users to the project, choose the **Add** button. To learn more, see [Add users to a team project or team](../../organizations/security/add-users-team-project.md). + +:::image type="content" source="media/summary/invite-members-tfs-2018.png" alt-text="Screenshot of Summary page, Add members button."::: +::: moniker-end + +::: moniker range="< azure-devops" > [!NOTE] -> The project page described in this section is available for TFS 2017.1 and later versions. It replaces the Welcome page used in TFS 2015 and TFS 2017. +> For on-premises Azure DevOps, all email actions require an [SMTP server to be configured](/azure/devops/server/admin/setup-customize-alerts). +::: moniker-end + + + +## View project activity + +From the **Project stats** or **Activity** section, you can view updates made to the project in the last 1, 7, or 30 days. Choose the view option as shown in the following image. + +::: moniker range=">= azure-devops-2019" +:::image type="content" source="media/summary/project-stats.png" alt-text="Screenshot of Summary page, Stats section."::: + ::: moniker-end + +::: moniker range="<= tfs-2018" +:::image type="content" source="media/summary/project-summary-activity-tfs-2018.png" alt-text="Screenshot of Summary page, Activity section, TFS-2018."::: +::: moniker-end + +## Email or chat with a project member + +From the **Members** section, you can see some of the members that have been added to the project, and connect to them via email or chat with a member. + +:::image type="content" source="media/summary/project-members.png" alt-text="Screenshot of Summary page, Members section."::: + +> [!NOTE] +> 100+ indicates that 100 or more members have been added to the project. + +To email or initiate a chat session, choose the team member shown and select your option. + +:::image type="content" source="media/summary/connect-with-team-member.png" alt-text="Screenshot of Summary page, Members section, options available to connect to a team member."::: + +::: moniker range="< azure-devops" +> [!NOTE] +> For on-premises Azure DevOps, all email actions require an [SMTP server to be configured](/azure/devops/server/admin/setup-customize-alerts). +::: moniker-end + +::: moniker range=">= azure-devops-2019" + +## Initiate a project search + +From the **Summary** page, you can initiate a search of your code, work items, and wiki. To learn more, see [Get started with search](../../project/search/get-started-search.md). +:::image type="content" source="media/summary/project-search.png" alt-text="Screenshot of Summary page, search box."::: ::: moniker-end @@ -113,7 +294,7 @@ You can share your project and objective, as well as ways for team members to co ::: moniker-end -::: moniker range="tfs-2018 || azure-devops" +::: moniker range="tfs-2018" 1. Open the Project home page. @@ -133,7 +314,7 @@ You can share your project and objective, as well as ways for team members to co ::: moniker-end -::: moniker range=">= tfs-2015 <= tfs-2017" +::: moniker range="<= tfs-2017" 1. You can start editing directly from the Welcome page. @@ -179,7 +360,6 @@ For projects that selected TFVC for version control, the README.md file needs to > ![Add new file dialog, new nav](media/share-project/create-readme-file-web-portal.png) 6. Add the contents of your README file in Markdown format, and then choose **Check in...**. - > [!div class="mx-imgBorder"] > ![Enter README file contents, new nav](media/share-project/tfvc-readme-file.png) @@ -195,7 +375,7 @@ For projects that selected TFVC for version control, the README.md file needs to ::: moniker-end -::: moniker range=">= tfs-2015 <= tfs-2018 || azure-devops" +::: moniker range="< azure-devops-2019" 1. Open the Project home page. @@ -214,94 +394,18 @@ Any additional Markdown files you have (ones with a *.md extension) in the root ::: moniker-end - - -## View project activity, add project members - -In addition to sharing information, the project summary page pulls data from the applications to give visitors a bird's-eye view of your project activity. - -::: moniker range=">= azure-devops-2019" -To add users to the project, select :::image type="icon" source="media/share-project/add-members-new-nav.png" border="false"::: **add**. You can only add users to a project that you have already added to the organization. To learn more, see [Add users to a team project or team](../../organizations/security/add-users-team-project.md). - -> [!div class="mx-imgBorder"] -> ![Project stats](media/share-project/project-stats-new-nav.png) - -::: moniker-end - -::: moniker range=">= tfs-2015 <= tfs-2018" - -To add users to the project, choose the **add** button. To learn more, see [Add users to a team project or team](../../organizations/security/add-users-team-project.md). - -![Project Home Page, Activity](../../project/wiki/media/project-home-page-activity.png) - -::: moniker-end - - - -## Change the repository - -You can change the repository used to support your project vision, including pointing it to the home page of your [built-in Wiki](../../project/wiki/wiki-create-repo.md). - -::: moniker range=">= azure-devops-2019" - -1. Open **Overview > Summary** . - -2. Select :::image type="icon" source="../../media/icons/edit.png" border="false"::: **Edit**. - - > [!div class="mx-imgBorder"] - > ![Choose README file, new nav](media/share-project/choose-readme-file-new-nav.png) - - If you don't see **Edit**, then you're not a member of the Project Administrators group. [Get added as an admin](../../organizations/security/set-project-collection-level-permissions.md) to proceed. - -3. Select a different repository or choose the Wiki option. - - > [!div class="mx-imgBorder"] - > ![Select a different repository or choose the Wiki option.](media/share-project/change-repo-new-nav.png) - - > [!TIP] - > If you choose the Wiki option, only the Wiki home page displays. To access additional Wiki pages, go to the Wiki. - -::: moniker-end - -::: moniker range=">= tfs-2015 <= tfs-2018 || azure-devops" - -1. From your project home page, choose **Change**. - - > [!div class="mx-imgBorder"] - > ![Project page, Change repo](media/share-project/markdown-welcome-page-change-location.png) - - If you don't see **Change** link, then you're not a member of the Project Administrators group. [Get added as an admin](../../organizations/security/set-project-collection-level-permissions.md) to proceed. - -2. From the select file dialog, choose an existing repo from the drop-down menu, or choose the Wiki option, shown as follows. - - Web portal, Project page, Select file to display dialog - - > [!TIP] - > Only the Wiki home page displays. To access additional Wiki pages, go to the Wiki. - -::: moniker-end - -## Next steps - -> [!div class="nextstepaction"] -> [Create a wiki for your team project](../../project/wiki/wiki-create-repo.md) - - - + diff --git a/docs/organizations/projects/toc.yml b/docs/organizations/projects/toc.yml index 929644756a7..21d8fafe11e 100644 --- a/docs/organizations/projects/toc.yml +++ b/docs/organizations/projects/toc.yml @@ -4,6 +4,9 @@ - name: Project & team quick reference href: project-team-quick-reference.md displayname: administrator, users, actions, manage, concepts +- name: Project summary + href: project-vision-status.md + displayname: readme, wiki, objective, administrator, summary, view, activity, members - name: Create a project href: create-project.md displayname: new, connect, list, add, repository @@ -41,9 +44,6 @@ - name: Manage your project href: ../../user-guide/project-admin-tutorial.md?toc=/azure/devops/organizations/toc.json&bc=/azure/devops/organizations/breadcrumb/toc.json displayname: policies, extensions - - name: Share your project vision - href: project-vision-status.md - displayname: readme, wiki, objective, administrator, summary, view, activity, members - name: Rename a project href: rename-project.md displayname: update, change, work item, query, version control paths diff --git a/docs/organizations/security/add-users-team-project.md b/docs/organizations/security/add-users-team-project.md index be3fb9a4f1a..2077f0a4932 100644 --- a/docs/organizations/security/add-users-team-project.md +++ b/docs/organizations/security/add-users-team-project.md @@ -95,7 +95,7 @@ Team and project administrators can add existing users to their team or project. Add existing users or groups to a team, or remove a member. :::column-end::: :::row-end::: -::: moniker range="azure-devops" +::: moniker range=">= tfs-2017" :::row::: :::column span="1"::: Project Administrators @@ -418,7 +418,7 @@ Choose the **Current page** tab for information on adding a user to a team. The ::: moniker range=">= azure-devops-2019" -5. To remove members, open the team's **Members** page, choose **direct** membership, return to this page, highlight the user name and choose **Remove**. +1. To remove members, open the team's **Members** page, choose **direct** membership, return to this page, highlight the user name and choose **Remove**. > [!div class="mx-imgBorder"] > ![Team profile page, remove a team member](media/add-users/team-page-remove-team-member-vert.png) @@ -444,18 +444,27 @@ Choose the **Current page** tab for information on adding a user to a team. The -::: moniker range="azure-devops" +::: moniker range=">= tfs-2017" ## Invite users from the Summary page -As a member of the Project Administrators group, you can add members to a project from the **Summary** page and optionally add them to one or more teams. - - +As a member of the Project Administrators group, you can add members to a project from the **Summary** page and optionally add them to one or more teams. To learn more about the **Summary** page, see [Share your project vision, view project activity](../../organizations/projects/project-vision-status.md). +::: moniker-end +::: moniker range="< azure-devops" +> [!NOTE] +> For on-premises Azure DevOps, all email actions require an [SMTP server to be configured](/azure/devops/server/admin/setup-customize-alerts). +::: moniker-end +::: moniker range="> azure-devops-2019" 1. Open the **Project>Summary** page, and choose **Invite**. :::image type="content" source="media/add-users/summary-invite-users.png" alt-text="Screenshot of Summary page, Invite button."::: - -2. For new users, enter their email address. For existing users, type their name until it resolves as a known name to the system. You can add several email addresses or account names by separating them with a semicolon (;). +::: moniker-end +::: moniker range=">=tfs-2017 <= tfs-2018" +1. Open the **Project>Summary** page, and choose the **Add** button. + :::image type="content" source="../projects/media/summary/invite-members-tfs-2018.png" alt-text="Screenshot of Summary page, Add members button."::: +::: moniker-end +::: moniker range=">= tfs-2017" +1. For new users, enter their email address. For existing users, type their name until it resolves as a known name to the system. You can add several email addresses or account names by separating them with a semicolon (;). :::row::: :::column span=""::: @@ -477,8 +486,7 @@ As a member of the Project Administrators group, you can add members to a projec > [!NOTE] > Any valid email address is acceptable. When the user accepts the invitation and signs into Azure DevOps, they register their email address as a Microsoft account and choose a password. - -2. Optionally, select the teams you want to add the user to and then choose **Add** to complete the invitation. +1. Optionally, select the teams you want to add the user to and then choose **Add** to complete the invitation. :::row::: :::column span=""::: @@ -533,11 +541,9 @@ As a member of the Project Administrators group, you can add members to a projec ::: moniker-end - - - + ## Add users or groups to a project As a member of the Project Administrators group, you can add users or groups to a project from the **Project settings> Permissions** page by adding them to a security group. To add a custom security group, see [Set permissions at the project- or collection-level](set-project-collection-level-permissions.md). diff --git a/docs/project/toc.yml b/docs/project/toc.yml index 890021a774b..b4ec7c60606 100644 --- a/docs/project/toc.yml +++ b/docs/project/toc.yml @@ -3,6 +3,9 @@ - name: Work across projects and services expanded: true items: + - name: Project summary + href: ../organizations/projects/project-vision-status.md?toc=/azure/devops/project/toc.json&bc=/azure/devops/project/breadcrumb/toc.json + displayname: stats, members, wiki, README, invite, share, collaborate - name: Work across projects href: navigation/work-across-projects.md - name: Work across projects FAQs diff --git a/docs/user-guide/project-admin-tutorial.md b/docs/user-guide/project-admin-tutorial.md index 92d18e407f9..60f2d39c31a 100644 --- a/docs/user-guide/project-admin-tutorial.md +++ b/docs/user-guide/project-admin-tutorial.md @@ -23,7 +23,7 @@ As an organization Owner or a Project Administrator, there are a few tasks you m ## Add users to your project ::: moniker range="azure-devops" -Ensure that all members of your organization or group are added to your organization and projects. For small groups, using [Microsoft Accounts](https://account.microsoft.com/account) to add users to your organization and projects works fine. +Ensure that all members of your organization or group are added to your organization and projects. For small projects, you can [invite users to your project or team](../security/add-users-team-project.md#invite-users-from-the-summary-page). Larger enterprises may want to consider using Azure Active Directory to manage permissions and user access. To learn more, see [About organization management](../organizations/accounts/organization-management.md). @@ -31,7 +31,7 @@ Larger enterprises may want to consider using Azure Active Directory to manage p ::: moniker range="< azure-devops" -Ensure that all members of your organization or group are added to your organization and project. Larger organizations may want to consider using Azure Active Directory to keep the maintenance of managing permissions and user access. Typically, you should install Azure Active Directory before installing TFS. To learn more, see the following articles. +Ensure that all members of your organization or group are added to your organization and project. For small projects, you can [invite users to your project or team](../security/add-users-team-project.md#invite-users-from-the-summary-page). Larger organizations may want to consider using Azure Active Directory to keep the maintenance of managing permissions and user access. Typically, you should install Azure Active Directory before installing TFS. To learn more, see the following articles. - [Install Azure Active Directory Domain Services (Level 100)](/windows-server/identity/ad-ds/deploy/install-active-directory-domain-services--level-100-) - [Step-By-Step: Setting up Azure Active Directory in Windows Server 2016](/archive/blogs/canitpro/step-by-step-setting-up-active-directory-in-windows-server-2016)