I've never really liked the *way* attributes get documented as it is so noisy (since the extra newline is always necessary). The newer ```#: Blah blah``` approach appeals for this reason (see http://sphinx-doc.org/ext/autodoc.html#directive-autoattribute). Your call on that one though...