Browse Source

Elaborate on wrapping styles

Alois Mahdal 10 years ago
parent
commit
75d7de4d9a
1 changed files with 8 additions and 3 deletions
  1. 8
    3
      guidelines/markdown.md

+ 8
- 3
guidelines/markdown.md View File

12
 Generic
12
 Generic
13
 -------
13
 -------
14
 
14
 
15
- *  Wrap at 75 columns at most (*fmt(1)* default).  Wrapping to less can
16
-    be beneficial (e.g. for re-quoting or in block comments) but less
17
-    than 61 is not considered sane.
15
+ *  Wrap at 75 columns at most (*fmt(1)* default).
16
+
17
+ *  Wrapping documents to less can be beneficial (e.g. for re-quoting).
18
+
19
+ *  Some lists, code blocks or blockquotes may look better wrapped
20
+    to less than surrounding paragraphs, i.e. to "make up" for the
21
+    left indentation.  (This is most apparent in case of medium-sized
22
+    list/block between paragraphs.)
18
 
23
 
19
  *  Try to have 2 spaces after sentence.
24
  *  Try to have 2 spaces after sentence.
20
 
25