Merge pull request #722 from Cadair/doc_sprint_2

Finish API docs
improve documentation surrounding optional deps
kill some automodapi bugs
more doc tweaking and warning removal
more error crushing
back to the astropy database rst
more database patching
fix database table docs