astropy/astropy — pull request #1682 by embray (2013-10-25 17:57:37+00:00)
Title: Add ability to provide descriptions for model parameters

As I mentioned in [this comment](https://github.com/astropy/astropy/pull/1086#issuecomment-27023264) it needs to be possible to provide documentation for model parameters. And furthermore that documentation needs to override each parameter's `__doc__`, since otherwise the Sphinx generated API docs just show the entire docstring for the `Parameter` class for every single parameter of every single model.

With this change all the parameters have empty docstrings, which leaves the API docs looking a little sparse. But it's at least less confusing.

We can add docstrings for individual parameters separately, either after 0.3 or now if someone wants to volunteer to start filling them in.