I’ve had some great success using the BizTalk Map Documentor:
It is a XSLT file that creates a nice HTML representation of maps including links, functoids and constants.
When coupling it with the Microsoft Command Line Transformation Utility and a batch file to loop through all of the contents of a directory, I can easily keep map documentation up-to-date. It’s a great way to communicate mappings to non-Biztalk folks. It is still technical documentation, but I’ve gotten good feedback from non-technical folks.
Here is the batch file I use:
for %%X in (C:\mymappath\*.btm) do c:\msxsl.exe “%%X” c:\BizTalkMapDocumenterHTML.xslt -O “%%X.html”
msxsl.exe and the BizTalkMapDocumentorHTML.xslt must be in the same directory.