Cleanup of documentation following comments by @eteq.
Cleanup of documentation following comments by @eteq.

astropy/astropy,StuartLittlefair/astropy,aleksandr-bakanov/astropy,pllim/astropy,larrybradley/astropy,joergdietrich/astropy,funbaker/astropy,AustereCuriosity/astropy,lpsinger/astropy,stargaser/astropy,saimn/astropy,mhvk/astropy,joergdietrich/astropy,stargaser/astropy,joergdietrich/astropy,AustereCuriosity/astropy,pllim/astropy,mhvk/astropy,tbabej/astropy,StuartLittlefair/astropy,funbaker/astropy,mhvk/astropy,StuartLittlefair/astropy,joergdietrich/astropy,aleksandr-bakanov/astropy,bsipocz/astropy,tbabej/astropy,saimn/astropy,larrybradley/astropy,stargaser/astropy,dhomeier/astropy,MSeifert04/astropy,kelle/astropy,DougBurke/astropy,pllim/astropy,funbaker/astropy,pllim/astropy,stargaser/astropy,bsipocz/astropy,saimn/astropy,astropy/astropy,pllim/astropy,astropy/astropy,dhomeier/astropy,saimn/astropy,lpsinger/astropy,joergdietrich/astropy,bsipocz/astropy,tbabej/astropy,StuartLittlefair/astropy,mhvk/astropy,larrybradley/astropy,lpsinger/astropy,kelle/astropy,AustereCuriosity/astropy,larrybradley/astropy,AustereCuriosity/astropy,kelle/astropy,aleksandr-bakanov/astropy,MSeifert04/astropy,aleksandr-bakanov/astropy,StuartLittlefair/astropy,funbaker/astropy,dhomeier/astropy,kelle/astropy,lpsinger/astropy,DougBurke/astropy,astropy/astropy,bsipocz/astropy,dhomeier/astropy,DougBurke/astropy,mhvk/astropy,larrybradley/astropy,DougBurke/astropy,MSeifert04/astropy,dhomeier/astropy,AustereCuriosity/astropy,tbabej/astropy,lpsinger/astropy,MSeifert04/astropy,kelle/astropy,saimn/astropy,tbabej/astropy,astropy/astropy