Skip to content

Commit 23e221b

Browse files
committed
Comment out the 'we' pronoun guideline
1 parent 782bff8 commit 23e221b

File tree

1 file changed

+6
-5
lines changed

1 file changed

+6
-5
lines changed

doc/contributing/docs/style.rst

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -27,11 +27,12 @@ in simpler terms than an advanced internals description.
2727
If you choose to use metaphors to clarify a concept, make sure they are relatable
2828
for an international audience of IT professionals.
2929

30-
Don't say "we"
31-
~~~~~~~~~~~~~~
30+
..
31+
_Don't say "we"!
32+
_~~~~~~~~~~~~~~!
3233
33-
Avoid using the pronoun "we".
34-
`Consider how Gentoo does it <https://wiki.gentoo.org/wiki/Gentoo_Wiki:Guidelines#Avoid_first_and_second_person_writing>`__.
34+
_Avoid using the pronoun "we", because it is unclear who that is exactly.!
35+
_`Consider how Gentoo does it <https://wiki.gentoo.org/wiki/Gentoo_Wiki:Guidelines#Avoid_first_and_second_person_writing>`__.!
3536

3637
Express one idea in a sentence
3738
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -118,7 +119,7 @@ Good example:
118119

119120
.. image:: /images/do.png
120121
:alt: Use the "list-table" directive instead
121-
122+
122123

123124
Format code as code
124125
~~~~~~~~~~~~~~~~~~~

0 commit comments

Comments
 (0)