Update grammar.adoc with guidance on inanimate users #495
Conversation
Co-authored-by: Andrea Hoffer <[email protected]>
Co-authored-by: Andrea Hoffer <[email protected]>
Nice improvement, thanks! Co-authored-by: Andrea Hoffer <[email protected]>
| == 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". | ||
|
|
||
| However, in certain technical cases, these users are not persons but instead user accounts or more abstract concepts. For example, Linux users such as root and guest 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. |
There was a problem hiding this comment.
| However, in certain technical cases, these users are not persons but instead user accounts or more abstract concepts. For example, Linux users such as root and guest 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 certain technical cases, these users are not persons but instead user accounts or more abstract concepts. 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". |
| image:images/no.png[no] A Linux user has the restrictions of the _SELinux user who_ it is assigned to. | ||
| + | ||
| image:images/no.png[no] A Linux user has the restrictions of the _SELinux user_ to _whom_ it is assigned. | ||
| + | ||
| image:images/yes.png[yes] Specify a _user that_ is allowed to perform the requested action. | ||
| + | ||
| image:images/yes.png[yes] A Linux user has the restrictions of the _SELinux user that_ it is assigned to. |
There was a problem hiding this comment.
... it is assigned to. Here it is inanimate and I believe it is referring to A Linux user. But IIUC, Linux user is still animate here, in which case we might have to say ..they are assigned to. instead. Feel free to correct me here.
There was a problem hiding this comment.
No, the Linux user here does not refer to a person who uses linux, but to the Linux user account, like guest.
There was a problem hiding this comment.
so we may want to emphasize on that too since it is overlooked currently.
e.g.
image:images/no.png[no] A _Linux user_ has the restrictions of the _SELinux user who it is_ assigned to.
There was a problem hiding this comment.
Hm, I tried to emphasize only the parts of speech to which the pronouns point (and the pronouns themselves). I think emphasizing this user would make it less clear, because no pronoun refers to it.
There was a problem hiding this comment.
... it is assigned to.Hereitis inanimate and I believe it is referring toA Linux user. But IIUC,Linux useris still animate here, in which case we might have to say ..they are assigned to.instead. Feel free to correct me here.
I thought it refers to Linux user
| @@ -128,4 +128,30 @@ Avoid long introductions and unnecessary context. Shorten unnecessarily long sen | |||
| === Principle 5: Error recovery, verification, and troubleshooting | |||
| Recognize that people make mistakes and need to verify that they have completed a task. Be sure to include troubleshooting, error recovery, and verification steps. | |||
|
|
|||
| [[users]] | |||
| == 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". | |||
There was a problem hiding this comment.
Thinking out aloud here. Do we want to differentiate them like the "task performer" vs "role references"?
There was a problem hiding this comment.
Sorry, I'm not sure I understand what you mean here.
Do you mean that we sometimes refer to "users" as those who perform the tasks (i.e. reader)?
And Linux and SELinux users and similar would be role references?
There was a problem hiding this comment.
I was trying to suggest some direct guidelines that would help writers make a decision. I was thinking something on the lines of:
"Task performers" -> Use animate
"Role references"-> Use inanimate
There was a problem hiding this comment.
I've thought about this, but I think this is too simple a recommendation. We can refer to personal users even when they are not task performers. In fact, we should typically refer to task performers as "you" and write directly to them.
Also, we should primarily write around role references instead of using the inanimate pronouns.
So I think the current recommendation is more accurate:
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".
Co-authored-by: Darragh Fitzmaurice <[email protected]>
Co-authored-by: Darragh Fitzmaurice <[email protected]>
Co-authored-by: Andrea Hoffer <[email protected]>
Co-authored-by: Andrea Hoffer <[email protected]>
|
Three approvals. Merging |
See Issue #466