Wiki-Move-FAQ.md

@@ -6,11 +6,11 @@ In order to support this transition we're providing the following documentation
 
 ## This seems like a pain, any automated options?
 
-For the download and conversion steps, yes!
+To download the text content and convert it, yes!
 
 You can use the [WikiCrawler](https://github.com/msohn/EclipseWikiCrawler) tool created by some of our community members(hat tip to @sandreevbjn and @msohn ).
 
-This tool does require that your wiki content be correctly categorized, and it leverages Docker and Pandoc to extract and convert content which you can then import directly into Gitlab/Github wikis(see the import section below).
+This tool does require that your wiki content be correctly [categorized](https://www.mediawiki.org/wiki/Help:Categories), and it leverages Docker and Pandoc to extract and convert content which you can then import directly into Gitlab/Github wikis(see the import section below).
 
 Check out the documentation for WikiCrawler if you have any specific questions about how to use it.
 
@@ -18,7 +18,7 @@ Check out the documentation for WikiCrawler if you have any specific questions a
 
 The process of extracting content from a MediaWiki install starts with the [Special:Export](https://wiki.eclipse.org/Special:Export) page.  
 
-If your existing content is correctly gathered under :Category: tags, you can simply add the Category tag to the top textbox and then click 'add'.
+If your existing content is correctly gathered under [:Category:](https://www.mediawiki.org/wiki/Help:Categories) tags, you can simply add the relevant Category tag to the top textbox and then click 'add'.   You may find it easier to add category tags to your existing page content to allow for better bulk exporting, rather than extporting individual pages.
 
 In other cases where the content is spread out you can export it by adding the page names(including the 'path') of the pages you want to export.  In the image below we're exporting 2 different FAQs; the Webmaster FAQ which lives at https://wiki.eclipse.org/Webmaster_FAQ and the CDT User FAQ which lives at https://wiki.eclipse.org/CDT/User/FAQ.  
 
@@ -27,7 +27,9 @@ NOTE: Page names are case sensitive, so if your content isn't exporting start by
 
 Once you've added your pages click the 'Export' button.  By default this will open a new tab with all of the page content as a single XML file, so you'll want to make sure the 'save as file' option is checked(see above image).
 
-Having all your content in a single file may not be desirable, in which case you'll probably want to export each wiki page into it's own XML file. 
+Having all your content in a single file may not be desirable, in which case you'll probably want to export each wiki page into it's own XML file before converting it.   
+
+The page history content is only supported by MediaWiki, and so for most transfers you'll just want to export the current version of the page.
 
 ## Manually converting to other Wiki formats