Browse Source

Elaborate on wrapping styles

Alois Mahdal 9 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,9 +12,14 @@ The guidelines take only original MD into account.
12 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 24
  *  Try to have 2 spaces after sentence.
20 25