On 12/11/2012 07:16 PM, Thomas Kluyver wrote:
On 11 December 2012 23:07, Tony Yu <tsy...@gmail.com
<mailto:tsy...@gmail.com>> wrote:
You suggest keeping the old examples around in some dark
corner. Is there some advantage you envision for doing this?
I'd just as soon remove them. Note that the documentation on
the website is now versioned, so the examples that shipped
with 1.2.0 will remain live and unchanged indefinitely. If a
user wants the older gallery it should just be there under
matplotlib.org/1.2 <http://matplotlib.org/1.2>.
I noted that old examples could either be kept in a dark corner,
or deleted. I'm actually strongly in favor of deleting, especially
since the website is versioned (nice---I didn't know this). I was
afraid some people would be resistant to deleting, but I'm happy
to hear that you prefer it. I'll make this preference clearer in
the MEP.
I haven't had time to consider all the details of this proposal, but
I'd like to advise against overzealous deletion. For those of us less
familiar with matplotlib's API, a pretty standard approach is to scan
through the examples gallery for the plot that looks most like the one
we want, copy the code and tweak it into what we need. So a big
gallery is very useful.
I don't think Tony was suggesting deleting many of the examples -- only
deleting any old stuff after reorganization of what we already have.
I was suggesting deleting a few examples that really aren't useful to
end users, and are really just unit tests (predating our unit test
framework). The sort of thing I was suggesting deleting are:
http://matplotlib.org/examples/api/donut_demo.html
which is really a unit test. It's highly unlikely the user would create
those shapes directly, and if they were we have the dolphin demo which
makes more sense from an end user perspective.
There are also examples that are sort of developer oriented that should
probably just be updated to be less so, for example:
http://matplotlib.org/examples/api/clippath_demo.html
It's perfectly reasonable code, but seems strange that it's clipped off
to the corner which I think makes it less useful as an example.
Of course, that doesn't mean it should grow ad infinitum, and I'm sure
you'll use good judgement on this. I just wanted to check you were
aware of this use case.
Absolutely. I think that's a major use case for the gallery.
Cheers,
Mike
Best wishes,
Thomas
------------------------------------------------------------------------------
LogMeIn Rescue: Anywhere, Anytime Remote support for IT. Free Trial
Remotely access PCs and mobile devices and provide instant support
Improve your efficiency, and focus on delivering more value-add services
Discover what IT Professionals Know. Rescue delivers
http://p.sf.net/sfu/logmein_12329d2d
_______________________________________________
Matplotlib-devel mailing list
Matplotlib-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/matplotlib-devel
