Skip to content

Commit 6ef5bf3

Browse files
authored
Merge pull request #495 from jafiala/The-personhood-of-users-#466
Update grammar.adoc with guidance on inanimate users
2 parents 226db83 + 4456325 commit 6ef5bf3

File tree

1 file changed

+26
-0
lines changed

1 file changed

+26
-0
lines changed

supplementary_style_guide/style_guidelines/grammar.adoc

+26
Original file line numberDiff line numberDiff line change
@@ -128,4 +128,30 @@ Avoid long introductions and unnecessary context. Shorten unnecessarily long sen
128128
=== Principle 5: Error recovery, verification, and troubleshooting
129129
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.
130130

131+
[[users]]
132+
== Users
133+
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".
134+
135+
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".
136+
137+
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".
138+
139+
.Examples
140+
* Animate user
141+
+
142+
image:images/no.png[no] Experienced _users that_ can configure their own systems...
143+
+
144+
image:images/yes.png[yes] _Users who_ want to install their own packages...
145+
146+
* Inanimate user
147+
+
148+
image:images/no.png[no] A Linux user has the restrictions of the _SELinux user who_ it is assigned to.
149+
+
150+
image:images/no.png[no] A Linux user has the restrictions of the _SELinux user_ to _whom_ it is assigned.
151+
+
152+
image:images/yes.png[yes] Specify a _user that_ is allowed to perform the requested action.
153+
+
154+
image:images/yes.png[yes] A Linux user has the restrictions of the _SELinux user that_ it is assigned to.
155+
156+
131157
// TODO: Add new style entries alphabetically in this file

0 commit comments

Comments
 (0)