[IPython-dev] documenting new packages

Jason Grout jason-sage at creativetrax.com
Fri May 4 22:16:05 EDT 2012


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.

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...

Jason





More information about the IPython-dev mailing list