Merge branch 'eread/bot-users-group-seat-clarification' into 'master'

Clarify that Bot users for groups don't use a licensed seat

See merge request gitlab-org/gitlab!79082

doc/api/users.md

@@ -533,7 +533,7 @@ Parameters:
 | Attribute     | Type    | Required | Description                                  |
 |---------------|---------|----------|----------------------------------------------|
 | `id`          | integer | yes      | The ID of a user                             |
-| `hard_delete` | boolean | no       | If true, contributions that would usually be [moved to the ghost user](../user/profile/account/delete_account.md#associated-records) are deleted instead, as well as groups owned solely by this user. |
+| `hard_delete` | boolean | no       | If true, contributions that would usually be [moved to Ghost User](../user/profile/account/delete_account.md#associated-records) are deleted instead, as well as groups owned solely by this user. |
 
 ## List current user (for normal users)
 

doc/subscriptions/gitlab_com/index.md

@@ -79,10 +79,12 @@ Every user is included in seat usage, with the following exceptions:
 
 - Users who are pending approval.
 - Members with the Guest role on an Ultimate subscription.
-- GitLab-created service accounts: `Ghost User` and bots
-  ([`Support Bot`](../../user/project/service_desk.md#support-bot-user),
-  [Bot users for projects](../../user/project/settings/project_access_tokens.md#bot-users-for-projects), and
-  so on.)
+- GitLab-created service accounts:
+  - [Ghost User](../../user/profile/account/delete_account.md#associated-records).
+  - Bots such as:
+    - [Support Bot](../../user/project/service_desk.md#support-bot-user).
+    - [Bot users for projects](../../user/project/settings/project_access_tokens.md#bot-users-for-projects).
+    - [Bot users for groups](../../user/group/settings/group_access_tokens.md#bot-users-for-groups).
 
 Seat usage is reviewed [quarterly or annually](../quarterly_reconciliation.md).
 

doc/subscriptions/self_managed/index.md

@@ -65,10 +65,12 @@ billable user, with the following exceptions:
 - Users who are [pending approval](../../user/admin_area/moderate_users.md#users-pending-approval).
 - Members with the Guest role on an Ultimate subscription.
 - Users without project or group memberships on an Ultimate subscription.
-- GitLab-created service accounts: `Ghost User` and bots
-  ([`Support Bot`](../../user/project/service_desk.md#support-bot-user),
-  [Bot users for projects](../../user/project/settings/project_access_tokens.md#bot-users-for-projects), and
-  so on.)
+- GitLab-created service accounts:
+  - [Ghost User](../../user/profile/account/delete_account.md#associated-records).
+  - Bots such as:
+    - [Support Bot](../../user/project/service_desk.md#support-bot-user).
+    - [Bot users for projects](../../user/project/settings/project_access_tokens.md#bot-users-for-projects).
+    - [Bot users for groups](../../user/group/settings/group_access_tokens.md#bot-users-for-groups).
 
 **Billable users** as reported in the `/admin` section is updated once per day.
 

doc/user/group/settings/group_access_tokens.md

@@ -143,5 +143,8 @@ Even when creation is disabled, you can still use and revoke existing group acce
 ## Bot users for groups
 
 Each time you create a group access token, a bot user is created and added to the group.
-These bot users are similar to [bot users for projects](../../project/settings/project_access_tokens.md#bot-users-for-projects), but are added to groups instead of projects. For more information, see
-[Bot users for projects](../../project/settings/project_access_tokens.md#bot-users-for-projects).
+These bot users are similar to [bot users for projects](../../project/settings/project_access_tokens.md#bot-users-for-projects),
+except they are added to groups instead of projects.
+These bot users do not count as licensed seats.
+
+For more information, see [Bot users for projects](../../project/settings/project_access_tokens.md#bot-users-for-projects).

doc/user/profile/account/delete_account.md

@@ -65,7 +65,7 @@ Here's a list of things created by the user that are **not** deleted:
 - Notes
 
 Instead of being deleted, these records are moved to a system-wide
-user with the username "Ghost User", whose sole purpose is to act as a container
+user with the username Ghost User, whose sole purpose is to act as a container
 for such records. Any commits made by a deleted user still display the
 username of the original user.
 

doc/user/project/settings/project_access_tokens.md

@@ -114,5 +114,6 @@ Bot users for projects:
 When the project access token is [revoked](#revoke-a-project-access-token):
 
 - The bot user is deleted.
-- All records are moved to a system-wide user with the username `Ghost User`. For more information, see
-  [associated records](../../profile/account/delete_account.md#associated-records).
+- All records are moved to a system-wide user with the username [Ghost User](../../profile/account/delete_account.md#associated-records).
+
+See also [Bot users for groups](../../group/settings/group_access_tokens.md#bot-users-for-groups).