#
#
# patch "wiki/ikiwikimigration.mdwn"
#  from [f554ca72f2e8b80307ddf43c24bb8633e4d7da32]
#    to [80898acddf84f85d3f50777eec3035c092cf7091]
#
============================================================
--- wiki/ikiwikimigration.mdwn	f554ca72f2e8b80307ddf43c24bb8633e4d7da32
+++ wiki/ikiwikimigration.mdwn	80898acddf84f85d3f50777eec3035c092cf7091
@@ -32,6 +32,18 @@ 3. Translate the markup:
 
     * use [[ikiwiki/formatting]] to help, and add more notes here
 
+    * when migrating page markup, try to minimise the number of
+      additional unrelated formatting changes (like reflowing
+      paragraphs) in the same commit.
+      That can be done as a separate step.
+
+      When flowing paragraphs, try to follow the "new sentence, new
+      line" convention.
+      Ikiwiki uses a blank line to break paragraphs.
+      This tends to mean that when someone else later adjusts a
+      few words in a paragraph, we don't get many
+      lines of sourounding diffs that are just reflowing.
+
 4. Generate, test, rinse, repeat.  `commit` now and again if you like,
    because your page is still tagged as unfinished.