Re: [Numpy-discussion] Improving Docs on Wiki

2008-03-26 Thread Jarrod Millman
On Fri, Mar 21, 2008 at 9:32 AM, Stéfan van der Walt <[EMAIL PROTECTED]> wrote: > > Not exactly. What do people think of the way I organized the numpy > > functions by category page? Apart from the sore-thumb "other" > > category, it does seem like the kind of grouping we might hope for. > >

Re: [Numpy-discussion] Improving Docs on Wiki

2008-03-21 Thread Joris De Ridder
On 21 Mar 2008, at 18:22, Joe Harrington wrote: > What you have brought up is really a documentation problem: how do I > find the name of the routine I want? One way of dealing with this, could be the implementation of a "doc()" function in numpy that helps you to find what you want. A (still

Re: [Numpy-discussion] Improving Docs on Wiki

2008-03-21 Thread Gary Strangman
>>> http://projects.scipy.org/scipy/numpy/wiki/CodingStyleGuidelines >> >> I realize this is a bit of a johnny-come-lately comment, but I was >> surprised to see that the list of sections does not seem to include the >> single most common reason I usually try to access a doc string ... the >> fu

Re: [Numpy-discussion] Improving Docs on Wiki

2008-03-21 Thread Pauli Virtanen
pe, 2008-03-21 kello 07:53 -0400, Gary Strangman kirjoitti: > > 4. Update the docstring, using the format suggested in > > > > http://projects.scipy.org/scipy/numpy/wiki/CodingStyleGuidelines > > I realize this is a bit of a johnny-come-lately comment, but I was > surprised to see that the list

Re: [Numpy-discussion] Improving Docs on Wiki

2008-03-21 Thread Joe Harrington
> Is it perhaps possible to make all numpy functions accessible in > submodules (in addition to in numpy, for backwards compatibility) and > then promote accessing them that way? I would caution on breaking functionality out into too many categories. It is *very* cumbersome to constantly import l

Re: [Numpy-discussion] Improving Docs on Wiki

2008-03-21 Thread Stéfan van der Walt
On Fri, Mar 21, 2008 at 5:00 PM, Anne Archibald <[EMAIL PROTECTED]> wrote: > On 21/03/2008, Stéfan van der Walt <[EMAIL PROTECTED]> wrote: > > On Fri, Mar 21, 2008 at 2:47 PM, Anne Archibald > > <[EMAIL PROTECTED]> wrote: > > > > Is it perhaps possible to make all numpy functions accessible in

Re: [Numpy-discussion] Improving Docs on Wiki

2008-03-21 Thread Anne Archibald
On 21/03/2008, Stéfan van der Walt <[EMAIL PROTECTED]> wrote: > On Fri, Mar 21, 2008 at 2:47 PM, Anne Archibald > <[EMAIL PROTECTED]> wrote: > > Is it perhaps possible to make all numpy functions accessible in > > submodules (in addition to in numpy, for backwards compatibility) and > > then

Re: [Numpy-discussion] Improving Docs on Wiki

2008-03-21 Thread Stéfan van der Walt
On Fri, Mar 21, 2008 at 2:47 PM, Anne Archibald <[EMAIL PROTECTED]> wrote: > On 21/03/2008, Sebastian Haase <[EMAIL PROTECTED]> wrote: > > > Comment: I have read the module- or directory-name "core" many times > > on this list, however: Who really knows where a given functions > > belongs ?

Re: [Numpy-discussion] Improving Docs on Wiki

2008-03-21 Thread Stéfan van der Walt
Hi Gary On Fri, Mar 21, 2008 at 12:53 PM, Gary Strangman <[EMAIL PROTECTED]> wrote: > > > 4. Update the docstring, using the format suggested in > > > > http://projects.scipy.org/scipy/numpy/wiki/CodingStyleGuidelines > > I realize this is a bit of a johnny-come-lately comment, but I was >

Re: [Numpy-discussion] Improving Docs on Wiki

2008-03-21 Thread Stéfan van der Walt
On Fri, Mar 21, 2008 at 1:54 PM, Sebastian Haase <[EMAIL PROTECTED]> wrote: > read relow... > > On Fri, Mar 21, 2008 at 11:21 AM, Stéfan van der Walt <[EMAIL PROTECTED]> > wrote: > > Hi Dieter > > > > On Fri, Mar 21, 2008 at 9:55 AM, <[EMAIL PROTECTED]> wrote: > > > I want to know if creatin

Re: [Numpy-discussion] Improving Docs on Wiki

2008-03-21 Thread Anne Archibald
On 21/03/2008, Sebastian Haase <[EMAIL PROTECTED]> wrote: > Comment: I have read the module- or directory-name "core" many times > on this list, however: Who really knows where a given functions > belongs ? Isn't that mostly only the numpy svn commiters ? > In other words, using only the pyth

Re: [Numpy-discussion] Improving Docs on Wiki

2008-03-21 Thread dieter h
On Fri, Mar 21, 2008 at 8:54 AM, Sebastian Haase <[EMAIL PROTECTED]> wrote: > read relow... > > NumpyDocstrings category on the wiki, and suggest that we organise the > > functions underneath it according to their numpy subpackage, e.g. > > > > scipy.org/NumpyDocstrings/core/sort > > > > If y

Re: [Numpy-discussion] Improving Docs on Wiki

2008-03-21 Thread Sebastian Haase
read relow... On Fri, Mar 21, 2008 at 11:21 AM, Stéfan van der Walt <[EMAIL PROTECTED]> wrote: > Hi Dieter > > On Fri, Mar 21, 2008 at 9:55 AM, <[EMAIL PROTECTED]> wrote: > > I want to know if creating individual documentation for each numpy > > routine on the scipy.org wiki would, for some admi

Re: [Numpy-discussion] Improving Docs on Wiki

2008-03-21 Thread Gary Strangman
> 4. Update the docstring, using the format suggested in > > http://projects.scipy.org/scipy/numpy/wiki/CodingStyleGuidelines I realize this is a bit of a johnny-come-lately comment, but I was surprised to see that the list of sections does not seem to include the single most common reason I

Re: [Numpy-discussion] Improving Docs on Wiki

2008-03-21 Thread Stéfan van der Walt
Hi Dieter On Fri, Mar 21, 2008 at 9:55 AM, <[EMAIL PROTECTED]> wrote: > I want to know if creating individual documentation for each numpy > routine on the scipy.org wiki would, for some administrative reason > (or other) be frowned upon. Here is an example of what I'd like to do > for all of

Re: [Numpy-discussion] Improving Docs on Wiki

2008-03-21 Thread Robert Kern
On Fri, Mar 21, 2008 at 3:55 AM, <[EMAIL PROTECTED]> wrote: > Hi, > > I want to know if creating individual documentation for each numpy > routine on the scipy.org wiki would, for some administrative reason > (or other) be frowned upon. Here is an example of what I'd like to do > for all of nu

[Numpy-discussion] Improving Docs on Wiki

2008-03-21 Thread vel . accel
Hi, I want to know if creating individual documentation for each numpy routine on the scipy.org wiki would, for some administrative reason (or other) be frowned upon. Here is an example of what I'd like to do for all of numpy's routines. http://www.scipy.org/sort. After each routine is properly d