mdboom/astropy — comment on commit fdf8557b66ef223654d30886f7cdb8bbe976aa4f
File: docs/conf.py line 20
By eteq:

Ah, so this re-formulates the VOTable spec to be more readable? In that case, it definitely makes sense to have this get put into a docstring somewhere, rather than generated as a file. Right now the vo.exceptions docstring only says "Exceptions and warnings used by the vo package." - you could change it to have sections for warnings and exceptions, and have the generate_warnings happen on import - then a user working in ipython or something can see the more-prettily formatted exceptions in the docstrings as well. Then just do:

.. automodule:: astropy.io.vo.exceptions

Somewhere in the sphinx docs, and you'll get just the exceptions docstring.