The question here seems to be 'what is documentation?'. If the 'stuff' your interested in needs to be accessible by reflection then your implied solution of attributes is a solution. But if the intent is to use standard documentation tools to build documentation then not so.
The need here begs the solution. What is the need for the 'documentation'. Perhaps the wrong question?
