astropy/astropy — pull request #279 by iguananaut (2012-06-13 17:48:41+00:00)
Title: Standardize section headings around Python documentation standards

The Python documentation recommends the following convention for section headings for all its documentation:
http://docs.python.org/devguide/documenting.html#sections

(Ironically, the Python developers' guide itself does not appear to follow its own convention).

I think it would be nice though to follow this convention for Astropy's docs too though. This pull request fixes up all our docs to do so, I think (though I could have missed some spots). I did not update the io.fits docs in this PR because I'm working on reorganizing them in another branch (where they will follow this convention).

I'm also having one problem building the docs: When generating the documentation for the astropy.table.Column class there's a table that gets left out because it's malformatted somehow--the table actually comes from the docstrings for ndarray, which Column inherits from.