explanatory text

diff --git a/doc/tips/convert_mediawiki_to_ikiwiki.mdwn b/doc/tips/convert_mediawiki_to_ikiwiki.mdwn
index ce0c684e7615e17784e9f6e1d34b666028e464db..3f771ed9bb4bbce006790e6826711f0040dcfe96 100644 (file)
--- a/doc/tips/convert_mediawiki_to_ikiwiki.mdwn
+++ b/doc/tips/convert_mediawiki_to_ikiwiki.mdwn
@@ -83,10 +83,13 @@ well-crafted queries.
 
 ## Step 2: format conversion
 
-The next step is to convert Mediawiki conventions into Ikiwiki ones. These
-include
+The next step is to convert Mediawiki conventions into Ikiwiki ones.
 
- * convert Categories into tags
+### categories
+
+Mediawiki uses a special page name prefix to define "Categories", which
+otherwise behave like ikiwiki tags. You can convert every Mediawiki category
+into an ikiwiki tag name using a script such as
 
     import sys, re
     pattern =  r'\[\[Category:([^\]]+)\]\]'