diff --git a/doc/workflow/add-user/add-user.md b/doc/workflow/add-user/add-user.md index 8c9b4f726316385a3ec7688ce5884ef40c76208f..fffa0aba57f3fa898f003633d4f23dfad1b295b6 100644 --- a/doc/workflow/add-user/add-user.md +++ b/doc/workflow/add-user/add-user.md @@ -1,25 +1,89 @@ # Project users -You can manage the groups and users and their access levels in all of your projects. You can also personalize the access level you give each user, per project. +You can manage the groups and users and their access levels in all of your +projects. You can also personalize the access level you give each user, +per-project. -Here's how to add or import users to your projects. - -You should have 'master' or 'owner' permissions to add or import a new user +You should have `master` or `owner` permissions to add or import a new user to your project. -To add or import a user, go to your project and click on "Members" on the left side of your screen: +The first step to add or import a user, go to your project and click on +**Members** on the left side of your screen. + + + +--- + +## Add a user + +Right next to **People**, start typing the name or username of the user you +want to add. + + + +--- + +Select the user and the [permission level](../../permissions/permissions.md) +that you'd like to give the user. Note that you can select more than one user. + + + +--- + +Once done, hit **Add users to project** and they will be immediately added to +your project with the permissions you gave them above. + + + +--- + +From there on, you can either remove an existing user or change their access +level to the project. + +## Import users from another project + +You can import another project's users in your own project by hitting the +**Import members** button on the upper right corner of the **Members** menu. + +In the dropdown menu, you can see only the projects you are Master on. + + + +--- + +Select the one you want and hit **Import project members**. A flash message +notifying you that the import was successful will appear, and the new members +are now in the project's members list. Notice that the permissions that they +had on the project you imported from are retained. + + + +--- + +## Invite people using their e-mail address + +If a user you want to give access to doesn't have an account on your GitLab +instance, you can invite them just by typing their e-mail address in the +user search field. + + + +--- - +As you can imagine, you can mix inviting multiple people and adding existing +GitLab users to the project. -Select "Add members" or "Import members" on the right side of your screen: + - +--- -If you are adding a user, select the user and the [permission level](doc/permissions/permissions.md) that you'd like to -give the user: +Once done, hit **Add users to project** and watch that there is a new member +with the e-mail address we used above. From there on, you can resend the +invitation, change their access level or even delete them. - + -If you are importing a user, follow the steps to select the project where you'd like to import the user from: +--- - +Once the user accepts the invitation, they will be prompted to create a new +GitLab account using the same e-mail address the invitation was sent to. diff --git a/doc/workflow/add-user/images/add-members.png b/doc/workflow/add-user/images/add-members.png deleted file mode 100644 index 2805c5764a577f4ea1cbf20047ebb3007c72e5f3..0000000000000000000000000000000000000000 Binary files a/doc/workflow/add-user/images/add-members.png and /dev/null differ diff --git a/doc/workflow/add-user/images/new-member.png b/doc/workflow/add-user/images/new-member.png deleted file mode 100644 index d500daea56e89f0a753d997469dbf593335f1457..0000000000000000000000000000000000000000 Binary files a/doc/workflow/add-user/images/new-member.png and /dev/null differ diff --git a/doc/workflow/add-user/images/select-project.png b/doc/workflow/add-user/images/select-project.png deleted file mode 100644 index dd3844edff8d6c6a379b5a9e565c81a7c5b3a8a2..0000000000000000000000000000000000000000 Binary files a/doc/workflow/add-user/images/select-project.png and /dev/null differ diff --git a/doc/workflow/add-user/img/add_new_user_to_project_settings.png b/doc/workflow/add-user/img/add_new_user_to_project_settings.png new file mode 100644 index 0000000000000000000000000000000000000000..3da18cdae53724d01439c3dfebcdc9cad35ab4c1 Binary files /dev/null and b/doc/workflow/add-user/img/add_new_user_to_project_settings.png differ diff --git a/doc/workflow/add-user/img/add_user_email_accept.png b/doc/workflow/add-user/img/add_user_email_accept.png new file mode 100644 index 0000000000000000000000000000000000000000..910affc9659eb1a298be9d55af5492950ba295b7 Binary files /dev/null and b/doc/workflow/add-user/img/add_user_email_accept.png differ diff --git a/doc/workflow/add-user/img/add_user_email_ready.png b/doc/workflow/add-user/img/add_user_email_ready.png new file mode 100644 index 0000000000000000000000000000000000000000..5f02ce89b3e1190d8579eb33f14afa80ed19d7a0 Binary files /dev/null and b/doc/workflow/add-user/img/add_user_email_ready.png differ diff --git a/doc/workflow/add-user/img/add_user_email_search.png b/doc/workflow/add-user/img/add_user_email_search.png new file mode 100644 index 0000000000000000000000000000000000000000..140979fbe13103533deba4ad8feb14f3df0c3585 Binary files /dev/null and b/doc/workflow/add-user/img/add_user_email_search.png differ diff --git a/doc/workflow/add-user/img/add_user_give_permissions.png b/doc/workflow/add-user/img/add_user_give_permissions.png new file mode 100644 index 0000000000000000000000000000000000000000..8ef9156c8d5c5ca2935420cbdd4f7b4083dca340 Binary files /dev/null and b/doc/workflow/add-user/img/add_user_give_permissions.png differ diff --git a/doc/workflow/add-user/img/add_user_import_members_from_another_project.png b/doc/workflow/add-user/img/add_user_import_members_from_another_project.png new file mode 100644 index 0000000000000000000000000000000000000000..5770d5cf0c4e2b3b24691a7e0bcd29d6f8b45583 Binary files /dev/null and b/doc/workflow/add-user/img/add_user_import_members_from_another_project.png differ diff --git a/doc/workflow/add-user/img/add_user_imported_members.png b/doc/workflow/add-user/img/add_user_imported_members.png new file mode 100644 index 0000000000000000000000000000000000000000..dea4b3f40adff254643ae04223be61b7e1523862 Binary files /dev/null and b/doc/workflow/add-user/img/add_user_imported_members.png differ diff --git a/doc/workflow/add-user/img/add_user_list_members.png b/doc/workflow/add-user/img/add_user_list_members.png new file mode 100644 index 0000000000000000000000000000000000000000..7daa6ca7d9e96b3692231615acf05ec11af3e05d Binary files /dev/null and b/doc/workflow/add-user/img/add_user_list_members.png differ diff --git a/doc/workflow/add-user/images/members.png b/doc/workflow/add-user/img/add_user_members_menu.png similarity index 100% rename from doc/workflow/add-user/images/members.png rename to doc/workflow/add-user/img/add_user_members_menu.png diff --git a/doc/workflow/add-user/img/add_user_search_people.png b/doc/workflow/add-user/img/add_user_search_people.png new file mode 100644 index 0000000000000000000000000000000000000000..5ac10ce80d4892a3cfdd125f824b5d9f0d3ace6e Binary files /dev/null and b/doc/workflow/add-user/img/add_user_search_people.png differ