Improved documentation around DownloadMixin.attachment

Refs #80.
This pull-request is based on @quietlyconfident's #81 with some changes:

* working in a topic branch
* some changes as noticed in comments of #81