[IPython-dev] Confusion about dev docs...take 2...

Thomas Kluyver takowl at gmail.com
Tue Oct 29 21:30:33 EDT 2013


On 29 October 2013 18:19, Brian Granger <ellisonbg at gmail.com> wrote:

> I am fine if we want to revisit the location of our dev docs, but
> until then, I think we should keep everything on Github...
>

I've rather gone off wiki-based docs. I think the model leads to poorly
curated information dumps, where nobody feels responsibility for the page
as a whole, and every bit of information is left there in case it's useful
to someone somewhere. Plus, for documenting code, Sphinx is just a much
nicer and more powerful system.

> If the issue is that you personally don't want to move it over to
> GitHub, I don't mind doing that.

Please don't. I think it's much better rendered in the docs, and has a
better chance of being kept up to date if changes are needed.

Thanks,
Thomas
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/ipython-dev/attachments/20131029/c350b94e/attachment.html>


More information about the IPython-dev mailing list