[IPython-dev] documenting new packages

[MinRK]

On Fri, May 4, 2012 at 7:16 PM, Jason Grout <jason-sage at creativetrax.com>wrote:

> On 5/4/12 9:14 PM, Jason Grout wrote:
> > On 5/4/12 8:37 PM, Paul Ivanov wrote:
> >> On Fri, May 4, 2012 at 5:07 PM, Paul Ivanov<pivanov314 at gmail.com>
> wrote:
> >>> On Fri, May 4, 2012 at 3:33 PM, Jason Grout<
> jason-sage at creativetrax.com>   wrote:
> >>>> I found this page very helpful to get a high-level overview of the
> >>>> organization:
> >>>>
> >>>> http://ipython.org/ipython-doc/dev/development/reorg.html
> >>>>
> >>>> However, it's missing several directories: nbformat, parallel,
> testing,
> >>>> and zmq.  If someone wants to reply with a sentence or two describing
> >>>> these directories, I can submit a pull request for the docs.  Or if
> >>>> someone wants to just that to the docs directly, even better!
> >>>
> >>> Thanks for point this out, Jason, I'm working on adding these changes
> right now.
> >>
> >> Thanks, again, Jason, this is now in [1]
> >>
> >> 1. https://github.com/ipython/ipython/commit/6d4f6b56
> >
> > I'm curious: how often is the documentation at
> >
> > http://ipython.org/ipython-doc/dev/development/reorg.html
> >
> > refreshed?  I thought maybe it was continually regenerated to reflect
> > the latest commits, but I don't see your changes there.
>
> Answering my own question, the bottom of that page says:
>
> Last updated on Apr 18, 2012.
>

That's the sphinx build date, I believe.


>
> Does that mean it is refreshed manually?  So I really should go to the
> source and generate my own docs if I really want cutting edge docs...
>

It's entered manually.  I didn't even know this file existed, and it was
last edited in October 2009.

-MinRK



>
> Jason
>
>
> _______________________________________________
> 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/20120504/43f28aa0/attachment.html>