I am a firm believer in using a tool to generate documentation; it makes it more accurate and ultimately more useful. With CRM 4.0 we used a tool that parsed the Customizations.xml to produce the documentation. A significant difference between CRM2011 and CRM4.0 is the managed solutions approach to customisations, making it much easier to move customisations between environments. However as a result of this change, the way that entity metadata is imported/exported has changed so that managed (out of the box) attributes are no longer included in the customizations.xml. This means that it is no longer possible to generate documentation from the customizations.xml and so any such tool must call the Organizations.svc web service to retrieve the metadata.
With this in mind, I spent some time this Christmas (in between eating turkey left overs) writing a Microsoft Word 2010 Add-In to aid the documentation process.
Download CRM2011WordDocumentor.zip (29.45 kb)
Merry Christmas and a Happy New Year!