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 started'

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 the

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 / methodology: what

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 this

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 him to

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 Gellner made

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

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