[IPython-dev] Confusion about dev docs...take 2...
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.
-------------- next part --------------
An HTML attachment was scrubbed...
More information about the IPython-dev