<div dir="ltr"><div style>Matthew:  Thanks for the link to array order discussion.</div><div><br></div>Any more thoughts on Phil's slice() function?</div><div class="gmail_extra"><br><br><div class="gmail_quote">On Fri, Apr 26, 2013 at 4:50 PM, Gael Varoquaux <span dir="ltr"><<a href="mailto:gael.varoquaux@normalesup.org" target="_blank">gael.varoquaux@normalesup.org</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div class="im">On Thu, Apr 25, 2013 at 08:10:32PM +0100, Robert Kern wrote:<br>
> In my opinion, duplicating functionality under different aliases just<br>
> so people can supposedly find things without reading the documentation<br>
> is not a viable strategy for building out an API.<br>
<br>
</div>+1. It's been my experience over and over again. Richer APIs are actually<br>
less used and known than simple APIs. People don't find their way around<br>
them.<br>
<div class="im"><br>
> My suggestion is to start building out a "How do I ...?" section to<br>
> the User's Guide that answers small questions like this. "How do I<br>
> iterate over an arbitrary axis of an array?" should be sufficiently<br>
> discoverable.<br>
<br>
</div>Indeed, I agree that this is a documentation problem. It does not make it<br>
a simple problem.<br>
<div class="HOEnZb"><div class="h5"><br>
G<br>
_______________________________________________<br>
NumPy-Discussion mailing list<br>
<a href="mailto:NumPy-Discussion@scipy.org">NumPy-Discussion@scipy.org</a><br>
<a href="http://mail.scipy.org/mailman/listinfo/numpy-discussion" target="_blank">http://mail.scipy.org/mailman/listinfo/numpy-discussion</a><br>
</div></div></blockquote></div><br><br clear="all"><div><br></div>-- <br>Andrew Giessel, PhD<br><br>Department of Neurobiology, Harvard Medical School<br>220 Longwood Ave Boston, MA 02115<br>ph: 617.432.7971 email: <a href="mailto:andrew_giessel@hms.harvard.edu" target="_blank">andrew_giessel@hms.harvard.edu</a>
</div>