[SciPy-dev] 2-review system on doc wiki

[David Goldsmith]

On Sun, Feb 14, 2010 at 11:56 AM, <josef.pktd at gmail.com> wrote:

>
> For some functions it will be difficult to determine what one level
> below the likely user actually means. I recently fixed a problem with
>

Maybe, maybe not: if in doubt, one could query the list "who uses this
function?"  Reply: "I do."  (Hopefully someone pipes up.)  Next query: "what
do you do/how do you use it?"  Reply: "I'm a physicist; I use it for my
research on quantum gravity."  Conclusion: "one level below" equals a
physics graduate student (or maybe post-doc).  Another (hopefully less
plausible) example: "Who uses 'dot'?"  A tsunami of replies: "I do."
Follow-up: "What do you do?"  Lowest level of replies: a high school student
taking AP Physics.  Conclusion: "one level below" equals a high school
student taking non-AP physics.  Not so hard - "loud" on the list, perhaps,
but not so hard.

DG


> http://docs.scipy.org/scipy/docs/scipy.signal.signaltools.hilbert/
> but I still don't know what the use for the analytical signal is or
> what it really means. I don't think a random user will bump into
> signal.hilbert, for example. And for a basic introduction Wikipedia is
> more informative than a docstring can be.
>
> Josef
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/scipy-dev/attachments/20100214/d2f9663d/attachment.html>