File tree Expand file tree Collapse file tree 1 file changed +6
-5
lines changed Expand file tree Collapse file tree 1 file changed +6
-5
lines changed Original file line number Diff line number Diff line change @@ -27,11 +27,12 @@ in simpler terms than an advanced internals description.
27
27
If you choose to use metaphors to clarify a concept, make sure they are relatable
28
28
for an international audience of IT professionals.
29
29
30
- Don't say "we"
31
- ~~~~~~~~~~~~~~
30
+ ..
31
+ _Don't say "we"!
32
+ _~~~~~~~~~~~~~~!
32
33
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>`__.!
35
36
36
37
Express one idea in a sentence
37
38
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -118,7 +119,7 @@ Good example:
118
119
119
120
.. image:: /images/do.png
120
121
:alt: Use the "list-table" directive instead
121
-
122
+
122
123
123
124
Format code as code
124
125
~~~~~~~~~~~~~~~~~~~
You can’t perform that action at this time.
0 commit comments