In my experience, generating documentation from code is a fools errand (unless it's API documentation). The key (and hard part) to documenting existing code is

In my experience, generating documentation from code is a fools errand (unless it's API documentation). The key (and hard part) to documenting existing code is to understand which details emphasize and which ones can be left out. I read documentation in order to more quickly understand a software component than I would by just reading it's code.