[IPython-dev] API documentation

Thomas Kluyver takowl at gmail.com
Tue Sep 11 16:53:42 EDT 2012


Fernando mentioned a couple of weeks ago the possibility of doing away
with our completely auto-generated API docs. I think having a degree
of manual control would be better for people who refer to the
documentation - as it can be clearer and better laid out - and for us,
in that it makes us think about what functions, methods and classes
comprise the public API.

I've made a start on that in this pull request:

https://github.com/ipython/ipython/pull/2383

It will be a fairly big job, so I wanted to discuss it before I spend
more time on it. I've used the auto-generated docs as a starting
point, and edited the rst. I've cut out a few helper classes and
functions, but if a class is included, all its methods are included
for now (except those marked _private).

Do you think it's worth replacing the auto-generated docs? If so, do
you think this is the right approach?

Thanks,
Thomas



More information about the IPython-dev mailing list