Astropy is discussing adding longer documentation relating to exceptions and errors and the like: https://groups.google.com/d/topic/astropy-dev/mS2dF0D-zkM/discussion We've recently gotten much better with handling exceptions, but this could be an interesting approach to take. -Matt