Merge branch 'sselhorn-groups-part2' into 'master'

More edits for style

See merge request gitlab-org/gitlab!54866

doc/user/group/index.md

@@ -50,130 +50,97 @@ For example, consider a user named Alex:
 
 ## Create a group
 
-NOTE:
-For a list of words that can not be used as group names, see
-[reserved names](../reserved_names.md).
-
-To create a new group, either:
-
-- In the top menu, click **Groups** and then **Your Groups**, and click the green button **New group**.
-
-  ![new group from groups page](img/new_group_from_groups.png)
-
-- Or, in the top menu, expand the `plus` sign and choose **New group**.
+To create a group:
 
-  ![new group from elsewhere](img/new_group_from_other_pages.png)
-
-Add the following information:
-
-![new group information](img/create_new_group_info.png)
-
-1. The **Group name** will automatically populate the URL. Optionally, you can change it.
-   This is the name that displays in group views.
-   The name can contain only:
+1. From the top menu, either:
+   - Select **Groups > Your Groups**, and on the right, select the **New group** button.
+   - To the left of the search box, select the plus sign and then **New group**.
+1. For the **Group name**, use only:
    - Alphanumeric characters
    - Underscores
    - Dashes and dots
    - Spaces
-1. The **Group URL** is the namespace under which your projects will be hosted.
-   The URL can contain only:
+
+   For a list of words that cannot be used as group names, see [reserved names](../reserved_names.md).
+1. For the **Group URL**, which is used for the [namespace](#namespaces),
+   use only:
    - Alphanumeric characters
    - Underscores
    - Dashes and dots (it cannot start with dashes or end in a dot)
-1. Optionally, you can add a brief description to tell others
-   what this group is about.
-1. Optionally, choose an avatar for your group.
 1. Choose the [visibility level](../../public_access/public_access.md).
+1. Invite GitLab members or other users to join the group.
 
-For more details on creating groups, watch the video [GitLab Namespaces (users, groups and subgroups)](https://youtu.be/r0sJgjR2f5A).
+<i class="fa fa-youtube-play youtube" aria-hidden="true"></i>
+For details about groups, watch [GitLab Namespaces (users, groups and subgroups)](https://youtu.be/r0sJgjR2f5A).
 
 ## Add users to a group
 
-A benefit of putting multiple projects in one group is that you can
-give a user access to all projects in the group with one action.
-
-Add members to a group by navigating to the group's dashboard and clicking **Members**.
+You can give a user access to all projects in a group.
 
-![add members to group](img/add_new_members_v13_7.png)
-
-Select the [permission level](../permissions.md#permissions), and add the new member. You can also set the expiring date for that user; this is the date on which they will no longer have access to your group.
-
-Consider a group with two projects:
-
-- On the **Group Members** page, you can now add a new user to the group.
-- Now, because this user is a **Developer** member of the group, they automatically
-  get **Developer** access to **all projects** within that group.
-
-To increase the access level of an existing user for a specific project,
-add them again as a new member to the project with the desired permission level.
+1. From the top menu, select **Groups > Your Groups**.
+1. Find your group and select it.
+1. From the left sidebar, select **Members**.
+1. Fill in the fields.
+   - The role applies to all projects in the group. [Learn more about permissions](../permissions.md#permissions).
+   - On the **Access expiration date**, the user can no longer access projects in the group.
 
 ## Request access to a group
 
-As a group owner, you can enable or disable the ability for non-members to request access to
-your group. Go to the group settings, and click **Allow users to request access**.
-
-As a user, you can request to be a member of a group, if that setting is enabled. Go to the group for which you'd like to be a member, and click the **Request Access** button on the right
-side of your screen.
+As a user, you can request to be a member of a group, if an administrator allows it.
 
-![Request access button](img/request_access_button.png)
+1. From the top menu, select **Groups > Your Groups**.
+1. Find the group and select it.
+1. Under the group name, select **Request Access**.
 
-Once access is requested:
+As many as ten of the most-recently-active group owners receive an email with your request.
+Any group owner can approve or decline the request.
 
-- Up to ten group owners are notified of your request via email.
-  Email is sent to the most recently active group owners.
-- Any group owner can approve or decline your request on the members page.
+If you change your mind before your request is approved, select
+**Withdraw Access Request**.
 
-![Manage access requests](img/access_requests_management.png)
+## Prevent users from requesting access to a group
 
-If you change your mind before your request is approved, just click the
-**Withdraw Access Request** button.
+As a group owner, you can prevent non-members from requesting access to
+your group.
 
-![Withdraw access request button](img/withdraw_access_request_button.png)
+1. From the top menu, select **Groups > Your Groups**.
+1. Find the group and select it.
+1. From the left menu, select **Settings > General**.
+1. Expand the **Permissions, LFS, 2FA** section.
+1. Clear the **Allow users to request access** checkbox.
+1. Select **Save changes**.
 
 ## Change the owner of a group
 
-Ownership of a group means at least one of its members has
-[Owner permission](../permissions.md#group-members-permissions). Groups must have at
-least one owner.
-
-Changing the owner of a group with only one owner is possible. To change the sole owner
-of a group:
+You can change the owner of a group. Each group must always have at least one
+member with [Owner permission](../permissions.md#group-members-permissions).
 
 - As an administrator:
-  1. Go to the group's **{users}** **Members** tab.
+  1. Go to the group and from the left menu, select **Members**.
   1. Give a different member **Owner** permissions.
   1. Refresh the page. You can now remove **Owner** permissions from the original owner.
 - As the current group's owner:
-  1. Go to the group's **{users}** **Members** tab.
+  1. Go to the group and from the left menu, select **Members**.
   1. Give a different member **Owner** permissions.
   1. Have the new owner sign in and remove **Owner** permissions from you.
 
 ## Remove a member from the group
 
-Only users with permissions of [Owner](../permissions.md#group-members-permissions) can manage
-group members.
-
-You can remove a member from the group if the given member has a direct membership in the group. If
-membership is inherited from a parent group, then the member can be removed only from the parent
-group itself.
-
-When removing a member, you can decide whether to unassign the user from all issues and merge
-requests they are currently assigned or leave the assignments as they are.
+Prerequisites:
 
-- **Unassigning the removed member** from all issues and merge requests might be helpful when a user
-  is leaving a private group and you wish to revoke their access to any issues and merge requests
-  they are assigned.
-- **Keeping the issues and merge requests assigned** might be helpful for groups that accept public
-  contributions where a user doesn't have to be a member to be able to contribute to issues and
-  merge requests.
+- You must have [Owner permissions](../permissions.md#group-members-permissions).
+- The member must have direct membership in the group. If
+  membership is inherited from a parent group, then the member can be removed
+  from the parent group only.
 
 To remove a member from a group:
 
-1. In a group, go to **{users}** **Members**.
-1. Click the **Delete** **{remove}** button next to a group member you want to remove.
-   A **Remove member** modal appears.
-1. (Optional) Select the **Also unassign this user from related issues and merge requests** checkbox.
-1. Click **Remove member**.
+1. Go to the group.
+1. From the left menu, select **Members**.
+1. Next to the member you want to remove, select **Delete**.
+1. Optional. On the **Remove member** confirmation box, select the
+  **Also unassign this user from related issues and merge requests** checkbox.
+1. Select **Remove member**.
 
 ## Filter and sort members in a group
 
@@ -745,7 +712,7 @@ To enable this feature:
 1. Expand the **Permissions, LFS, 2FA** section, and select **Disable group mentions**.
 1. Click **Save changes**.
 
-#### Enabling delayed Project removal **(PREMIUM)**
+#### Enabling delayed project removal **(PREMIUM)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/220382) in GitLab 13.2.