Merge branch 'sselhorn-master-patch-54766' into 'master'

Updating the role guidance

See merge request https://gitlab.com/gitlab-org/gitlab/-/merge_requests/100039



Merged-by: Evan Read <eread@gitlab.com>
Approved-by: Evan Read <eread@gitlab.com>
Co-authored-by: Suzanne Selhorn <sselhorn@gitlab.com>

doc/development/documentation/styleguide/word_list.md

@@ -513,13 +513,16 @@ For example, **Snowplow Guide**. Instead, speak about the feature itself, and ho
 When writing about the Guest role:
 
 - Use a capital **G**.
-- Do not use bold.
-- Do not use the phrase, **if you are a guest** to mean someone who is assigned the Guest
-  role. Instead, write it out. For example, **if you are assigned the Guest role**.
-- To describe a situation where the Guest role is the minimum required:
+- Write it out:
+  - Use: if you are assigned the Guest role
+  - Instead of: if you are a guest
+
+- When the Guest role is the minimum required role:
   - Use: at least the Guest role
   - Instead of: the Guest role or higher
 
+Do not use bold.
+
 Do not use **Guest permissions**. A user who is assigned the Guest role has a set of associated permissions.
 
 ## handy
@@ -660,13 +663,16 @@ Instead of:
 When writing about the Maintainer role:
 
 - Use a capital **M**.
-- Do not use bold.
-- Do not use the phrase, **if you are a maintainer** to mean someone who is assigned the Maintainer
-  role. Instead, write it out. For example, **if you are assigned the Maintainer role**.
-- To describe a situation where the Maintainer role is the minimum required:
+- Write it out.
+  - Use: if you are assigned the Maintainer role
+  - Instead of: if you are a maintainer
+
+- When the Maintainer role is the minimum required role:
   - Use: at least the Maintainer role
   - Instead of: the Maintainer role or higher
 
+Do not use bold.
+
 Do not use **Maintainer permissions**. A user who is assigned the Maintainer role has a set of associated permissions.
 
 ## mankind
@@ -800,11 +806,14 @@ For example, a log file might overwrite a log file of the same name.
 When writing about the Owner role:
 
 - Use a capital **O**.
-- Do not use bold.
-- Do not use the phrase, **if you are an owner** to mean someone who is assigned the Owner
-  role. Instead, write it out. For example, **if you are assigned the Owner role**.
+- Write it out.
+  - Use: if you are assigned the Owner role
+  - Instead of: if you are an owner
 
+Do not use bold.
+ 
 Do not use **Owner permissions**. A user who is assigned the Owner role has a set of associated permissions.
+An Owner is the highest role a user can have.
 
 ## Package Registry
 
@@ -855,13 +864,16 @@ Use **register** instead of **sign up** when talking about creating an account.
 When writing about the Reporter role:
 
 - Use a capital **R**.
-- Do not use bold.
-- Do not use the phrase, **if you are a reporter** to mean someone who is assigned the Reporter
-  role. Instead, write it out. For example, **if you are assigned the Reporter role**.
-- To describe a situation where the Reporter role is the minimum required:
+- Write it out.
+  - Use: if you are assigned the Reporter role
+  - Instead of: if you are a reporter
+
+- When the Reporter role is the minimum required role:
   - Use: at least the Reporter role
   - Instead of: the Reporter role or higher
 
+Do not use bold.
+
 Do not use **Reporter permissions**. A user who is assigned the Reporter role has a set of associated permissions.
 
 ## Repository Mirroring