summaryrefslogtreecommitdiffstats
path: root/tags/u/using-first-person-in-description.tag
diff options
context:
space:
mode:
Diffstat (limited to 'tags/u/using-first-person-in-description.tag')
-rw-r--r--tags/u/using-first-person-in-description.tag12
1 files changed, 12 insertions, 0 deletions
diff --git a/tags/u/using-first-person-in-description.tag b/tags/u/using-first-person-in-description.tag
new file mode 100644
index 0000000..9dd6022
--- /dev/null
+++ b/tags/u/using-first-person-in-description.tag
@@ -0,0 +1,12 @@
+Tag: using-first-person-in-description
+Severity: info
+Check: fields/description
+Explanation: You should avoid the use of first person ("I will do this..." or
+ "We recommend..."). The computer is not a person and the description
+ does not speak for the maintainer or maintainers. Instead, use a more
+ neutral construction and try to rephrase into factual statements about
+ the package.
+ .
+ For example, rather than saying "I don't recommend this package if you
+ are short on memory," say something like "this package is not suitable
+ for low-memory systems."