Hi, Denis.  I merely want to reinforce what Ralf has said, vis-a-vis our docstring editing Wiki: its very purpose is to maximize participation in *generating* docstrings (the preferred &quot;baseline&quot; documentation in Python), while also (hopefully) assuring the highest quality for what actually ends up in the code by regulating who gets to &quot;review&quot; and &quot;approve&quot; the docstrings.  Also, there resides a link to our official docstring standard, with which all docstrings are required to comply.  We heartily encourage new docstring &quot;editors&quot; (i.e., contributors) but, as hinted at by Ralf, rather than submit docstring contributions via the listserve, we find it much more efficient and useful for editors (and essentially require reviewers) to use the Wiki; don&#39;t worry about it being vetted before you contribute it, that&#39;s one of the functions for which the Wiki is set-up/designed.  I believe Ralf provided the link to the Wiki&#39;s &quot;Front Page&quot; - which contains all essential introductory information and links - earlier in this thread, but if you need any help, feel free to email me (or Ralf - I think I can safely speak for him in this regard) off-list.  One thing, however: we prefer discussion of docstring and Wiki issues to take place on scipy-dev, and thus encourage you to subscribe - and post this kind of material - to that list.  I sincerely hope none of this discourages your participation - that would be the opposite of my intent - and wholeheartedly welcome you to our &quot;editorial community.&quot; :-)  Thanks for your efforts,<br>
<br>David Goldsmith<br>Technical Editor<br>Olympia, WA, USA<br><br><div class="gmail_quote">On Tue, Oct 6, 2009 at 12:15 PM, Ralf Gommers <span dir="ltr">&lt;<a href="mailto:ralf.gommers@googlemail.com">ralf.gommers@googlemail.com</a>&gt;</span> wrote:<br>
<blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;"><br><br><div class="gmail_quote"><div class="im">On Mon, Oct 5, 2009 at 12:55 PM, denis <span dir="ltr">&lt;<a href="mailto:denis-bz-gg@t-online.de" target="_blank">denis-bz-gg@t-online.de</a>&gt;</span> wrote:<br>
<blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
<div>On Oct 5, 10:01 am, Ralf Gommers &lt;<a href="mailto:ralf.gomm...@googlemail.com" target="_blank">ralf.gomm...@googlemail.com</a>&gt; wrote:<br>
&gt; Hi, did you send this to the list because you want to add it to the docs<br>
</div>&gt; (like herehttp://<a href="http://docs.scipy.org/doc/scipy/reference/tutorial/ndimage.html" target="_blank">docs.scipy.org/doc/scipy/reference/tutorial/ndimage.html</a>)<br>
&gt; ?<br>
<br>
I was hoping for comments first: is it readable, accurate, the right<br>
level for anybody ?<br></blockquote></div><div><br>I think that it has the right level of detail for it to be added to the ndimage tutorial, maybe even for the map_coordinates docstring with minor modifications. I will reply with some more detailed comments in a minute.<br>

<br></div><div class="im"><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
(Unreviewed doc is the curse of the web.<br>
My imaginary bandwagon for BetterDoc includes better indexing /<br>
tagging<br>
and examples of good doc in various categories.)<br></blockquote></div><div><br>One hundred percent agreed. This is what the doc wiki is about. It has a commenting system and edit history, so it works better than the mailing list for this. Also, the edits only get merged into the built documentation after review, so no worries there. I encourage you to check it out.<br>

</div><div class="im"><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
<br>
How about <a href="http://advice.mechanicalkern.com" target="_blank">http://advice.mechanicalkern.com</a> ? looks to be in the right<br>
direction.<br></blockquote></div><div><br>Interesting, I had not seen that site before. I would imagine that answers from that site get integrated in the reference/user guides where appropriate.<br><br>Cheers,<br><font color="#888888">Ralf<br>
 <br>
</font></div><div class="im"><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
<br>
cheers<br>
<font color="#888888">  -- denis<br>
</font><div><div></div><div>_______________________________________________<br>
SciPy-User mailing list<br>
<a href="mailto:SciPy-User@scipy.org" target="_blank">SciPy-User@scipy.org</a><br>
<a href="http://mail.scipy.org/mailman/listinfo/scipy-user" target="_blank">http://mail.scipy.org/mailman/listinfo/scipy-user</a><br>
</div></div></blockquote></div></div><br>
<br>_______________________________________________<br>
SciPy-User mailing list<br>
<a href="mailto:SciPy-User@scipy.org">SciPy-User@scipy.org</a><br>
<a href="http://mail.scipy.org/mailman/listinfo/scipy-user" target="_blank">http://mail.scipy.org/mailman/listinfo/scipy-user</a><br>
<br></blockquote></div><br>