os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Whitespace-only changes. Translators, please ignore.

Browse source
This commit is contained in:
Warren Block 2013-06-26 04:24:45 +00:00
parent 7f2a4285e5
commit 181fb984e1
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=42059
1 changed files with 8 additions and 8 deletions

16
en_US.ISO8859-1/books/fdp-primer/writing-style/chapter.xml
View file

@ -71,14 +71,14 @@
rather than <quote>you can copy the file to
<filename>/tmp</filename></quote>.</para>
<para>Give clear, correct, <emphasis>tested</emphasis> examples. A trivial example is better
than no example. A good example is better yet. Do not
give bad examples, identifiable by apologies or sentences like
<quote>but really it should never be done that way</quote>.
Bad examples are worse than no examples. Give good examples,
because <emphasis>even when warned not to use the example
as shown</emphasis>, the reader will usually just use the
example as shown.</para>
<para>Give clear, correct, <emphasis>tested</emphasis> examples.
A trivial example is better than no example. A good example
is better yet. Do not give bad examples, identifiable by
apologies or sentences like <quote>but really it should never
be done that way</quote>. Bad examples are worse than no
examples. Give good examples, because <emphasis>even when
warned not to use the example as shown</emphasis>, the
reader will usually just use the example as shown.</para>
<para>Avoid <emphasis>weasel words</emphasis> like
<quote>should</quote>, <quote>might</quote>,