Re: [Numpy-discussion] [SciPy08] Documentation BoF

2008-08-27 Thread Stéfan van der Walt
Hi Neil 2008/8/26 Neil Crighton <[EMAIL PROTECTED]>: >> >> - Should we have a separate User manual and a Reference manual, or only >> a single manual? >> > > Are there still plans to write a 10 page 'Getting started with NumPy' > document? I think this would be very useful. Ideally a 'getting st

Re: [Numpy-discussion] [SciPy08] Documentation BoF

2008-08-26 Thread Neil Crighton
> > - Should we have a separate User manual and a Reference manual, or only > a single manual? > Are there still plans to write a 10 page 'Getting started with NumPy' document? I think this would be very useful. Ideally a 'getting started' document, the docstrings, and a reference manual is all

Re: [Numpy-discussion] [SciPy08] Documentation BoF

2008-08-25 Thread Sebastien Binet
On Monday 25 August 2008 10:36:03 Travis E. Oliphant wrote: > Pauli Virtanen wrote: > > - I vaguely remember someone mentioned having done numpybook -> RST > > conversion. If so, is the result somewhere available? > > Was something done towards this in the Scipy'08 sprints? > > Yes, Gabriel Gel

Re: [Numpy-discussion] [SciPy08] Documentation BoF

2008-08-25 Thread Travis E. Oliphant
Pauli Virtanen wrote: > > - I vaguely remember someone mentioned having done numpybook -> RST > conversion. If so, is the result somewhere available? > Was something done towards this in the Scipy'08 sprints? > > Yes, Gabriel Gellner made progress on this during the sprints, and I asked hi

Re: [Numpy-discussion] [SciPy08] Documentation BoF

2008-08-25 Thread Jarrod Millman
On Mon, Aug 25, 2008 at 4:18 AM, Pauli Virtanen <[EMAIL PROTECTED]> wrote: > - I vaguely remember someone mentioned having done numpybook -> RST > conversion. If so, is the result somewhere available? > Was something done towards this in the Scipy'08 sprints? Yes. Gabriel Gellner is working on

Re: [Numpy-discussion] [SciPy08] Documentation BoF

2008-08-25 Thread Pauli Virtanen
Mon, 25 Aug 2008 00:05:06 +0200, Ondrej Certik wrote: > On Fri, Aug 22, 2008 at 10:26 AM, Stéfan van der Walt <[EMAIL PROTECTED]> > wrote: [clip] >> - Path towards getting SciPy documented using the online documentation >> editor >> - Intersphinx: linking Sphinx-using projects - Culture / methodolo

Re: [Numpy-discussion] [SciPy08] Documentation BoF

2008-08-24 Thread Robert Kern
On Sun, Aug 24, 2008 at 15:05, Ondrej Certik <[EMAIL PROTECTED]> wrote: > Currently sphinx can't handle scipy docstrings, can it? It didn't for > me at least. It'd be nice if whatever format you agre upon, could work > with sphinx's autodoc. We do some preprocessing, I believe. > Also I am very i

Re: [Numpy-discussion] [SciPy08] Documentation BoF

2008-08-24 Thread Ondrej Certik
On Fri, Aug 22, 2008 at 10:26 AM, Stéfan van der Walt <[EMAIL PROTECTED]> wrote: > Hi all, > > This is my personal recollection of the documentation BoF. Feel free to > comment or correct the text below. > > Regards > Stéfan > > > Summary of the Documentation Birds-of-a-Feather Session > =

[Numpy-discussion] [SciPy08] Documentation BoF

2008-08-22 Thread Stéfan van der Walt
Hi all, This is my personal recollection of the documentation BoF. Feel free to comment or correct the text below. Regards Stéfan Summary of the Documentation Birds-of-a-Feather Session === Topics proposed for discussion