diff --git a/index.html b/index.html index a61d8e8a..4ee39df5 100644 --- a/index.html +++ b/index.html @@ -3011,6 +3011,7 @@

Red Hat supplementary style guide for product documentation

  • Conversational style
  • Homographs
  • Minimalism
    • +
  • Users
  • Formatting @@ -4575,6 +4576,47 @@
    +

    Users

    +
    +

    In most cases, the word "user" refers to a person or a person’s user account, and therefore would be considered animate. In these cases, use animate personal pronouns such as "who".

    +
    +
    +

    In certain technical cases, these users are not persons but instead system accounts or more abstract concepts (inanimate). For example, Linux root and guest users do not relate to any person. Applications and services might run as specific Linux users with no person controlling them. SELinux users such as user_u or sysadm_u are identifiers of one or multiple Linux users for access control purposes. In these specific cases, refer to these inanimate users with inanimate personal pronouns such as "that".

    +
    +
    +

    In these specific cases, and only if you cannot write around it, you can refer to these inanimate users with inanimate personal pronouns such as "that".

    +
    +
    +
    Examples
    +
      +
    • +

      Animate user

      +
      +

      no Experienced users that can configure their own systems…​

      +
      +
      +

      yes Users who want to install their own packages…​

      +
      +
      • +
    • +

      Inanimate user

      +
      +

      no A Linux user has the restrictions of the SELinux user who it is assigned to.

      +
      +
      +

      no A Linux user has the restrictions of the SELinux user to whom it is assigned.

      +
      +
      +

      yes Specify a user that is allowed to perform the requested action.

      +
      +
      +

      yes A Linux user has the restrictions of the SELinux user that it is assigned to.

      +
      +
      • +
    +
    +

    Formatting

    @@ -22993,7 +23035,7 @@