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

Thomas Kluyver takowl at gmail.com
Tue Oct 29 21:09:12 EDT 2013


I'm not sure that the distinction is that clear - all of the docs already
in that section seem potentially useful to people working on IPython
itself, as well as on related projects. The version compatibility stuff
could also be useful to developers of related projects, although there's
plenty of other such advice out there on the net.

But ultimately, I just preferred to do this as a Sphinx doc than a wiki
page.

Thomas


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

> OK, let me try this again...
>
> Here is what our Sphinx docs say about "Development related docs":
>
> ###
> This are two categories of developer focused documentation:
>
> Documentation for developers of IPython itself.
> Documentation for developers of third party tools and libraries that
> use IPython.
>
> This part of our documentation only contains information in the second
> category.
>
> Developers interested in working on IPython itself should consult our
> developer information on the IPython GitHub wiki.
> ###
>
> To me this suggests that anything related to writing code for IPython
> should go in the GitHub wiki. That is what I thought we were doing.
> OK, all of that makes sense to me.
>
> But then I just saw the Python 2+3 dev docs were put into the Sphinx docs:
>
> http://ipython.org/ipython-doc/dev/development/pycompat.html
>
> Shouldn't this be on Github as it only really relates to people
> writing code for IPython?
>
> Cheers,
>
> Brian
>
>
> --
> Brian E. Granger
> Cal Poly State University, San Luis Obispo
> bgranger at calpoly.edu and ellisonbg at gmail.com
> _______________________________________________
> IPython-dev mailing list
> IPython-dev at scipy.org
> http://mail.scipy.org/mailman/listinfo/ipython-dev
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/ipython-dev/attachments/20131029/d41acf26/attachment.html>


More information about the IPython-dev mailing list