<div dir="ltr">I would favor accepting a one-time breakage (as others mentioned it's really not that bad), and start versioning the docs (redirect <a href="http://matplotlib.org">matplotlib.org</a> to <a href="http://matplotlib.org/$latest_ver">matplotlib.org/$latest_ver</a> and so on). See also <a href="https://www.python.org/dev/peps/pep-0430/">https://www.python.org/dev/peps/pep-0430/</a>.</div><div class="gmail_extra"><br><div class="gmail_quote">2017-02-14 14:25 GMT-08:00 Benjamin Root <span dir="ltr"><<a href="mailto:ben.v.root@gmail.com" target="_blank">ben.v.root@gmail.com</a>></span>:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr">I am not too worried about bookmarks. Rather, it is tutorials. We have no mechanism for permalinking specific examples, which means tutorials eventually break. It isn't utterly terrible, but it is annoying. I wouldn't use it as a reason to not re-organize examples at all (it isn't API), but I wouldn't make a habit of reorganizing things every few releases.<br></div><div class="HOEnZb"><div class="h5"><div class="gmail_extra"><br><div class="gmail_quote">On Tue, Feb 14, 2017 at 4:54 PM, Nelle Varoquaux <span dir="ltr"><<a href="mailto:nelle.varoquaux@gmail.com" target="_blank">nelle.varoquaux@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote"><span>On 13 February 2017 at 16:40, Thomas Caswell <span dir="ltr"><<a href="mailto:tcaswell@gmail.com" target="_blank">tcaswell@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><p dir="ltr">yes, i will give access to anyone who wants.</p><div class="m_6742141918171814406m_-3292747440611279685HOEnZb"><div class="m_6742141918171814406m_-3292747440611279685h5">
<br><div class="gmail_quote"><div dir="ltr">On Mon, Feb 13, 2017, 19:38 Nelle Varoquaux <<a href="mailto:nelle.varoquaux@gmail.com" target="_blank">nelle.varoquaux@gmail.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr" class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg"><div class="gmail_extra m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg"><div class="gmail_quote m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg"><br class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg"><blockquote class="gmail_quote m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr" class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg">It's a shame that the main documentation does not redirect to the versioned documentation. It would be nice it the only pages bookmarked would be <div class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg"><a href="http://matplotlib.org/majorversion/examples/." class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg" target="_blank">matplotlib.org/majorversion/ex<wbr>amples/.</a>.. that way we would get the best of both worlds imho. If we can find a simple way of generating redirects as Adrien suggests that sounds reasonable too. I think we should try hard to find a way to move the pylab examples to a folders with a more meaningful name as well as deleting a fair number of examples</div></div></blockquote><div class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg"><br class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg"></div></div></div></div><div dir="ltr" class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg"><div class="gmail_extra m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg"><div class="gmail_quote m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg"><div class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg">Somewhat related to deleting examples, do we have any kind of analytics on our website frequency usage? something like google analytics. It could help us see what people are using in our documentation.</div></div></div></div></blockquote></div></div></div></blockquote><div><br></div></span><div>I am interested: I think it should help us see which examples are frequently accessed and those which aren't, and could help us merging some examples together.</div><div><br></div><div>I also think we shouldn't be too concerned with breaking people's bookmarks: if someone has a broken bookmark, it is fairly easy to google for the replacement.</div><div>If renaming, moving or deleting an example makes our life easier, I think we should go forward with that.</div><div><br></div><div>My 2 cents,</div><div>N</div><div><div class="m_6742141918171814406h5"><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div class="m_6742141918171814406m_-3292747440611279685HOEnZb"><div class="m_6742141918171814406m_-3292747440611279685h5"><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr" class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg"><div class="gmail_extra m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg"><div class="gmail_quote m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg"><div class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg"> <br class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg"></div><blockquote class="gmail_quote m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr" class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg"><div class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg"><span class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207m_-8748275103433739441HOEnZb m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg"><font class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg" color="#888888"><br class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg"></font></span></div><span class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207m_-8748275103433739441HOEnZb m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg"><font class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg" color="#888888"><div class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg"><br class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg"></div><div class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg">Jens</div></font></span></div><div class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207m_-8748275103433739441HOEnZb m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg"><div class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207m_-8748275103433739441h5 m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg"><br class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg"><div class="gmail_quote m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg"><div dir="ltr" class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg">On Mon, 13 Feb 2017 at 08:32 <a href="mailto:vincent.adrien@gmail.com" class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg" target="_blank">vincent.adrien@gmail.com</a> <<a href="mailto:vincent.adrien@gmail.com" class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg" target="_blank">vincent.adrien@gmail.com</a>> wrote:<br class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg"></div><blockquote class="gmail_quote m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Hi Thomas,<br class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207m_-8748275103433739441m_5598282663562434544gmail_msg m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg">
<br class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207m_-8748275103433739441m_5598282663562434544gmail_msg m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg">
I guess the less imaginative solution may be a simple page referencing the URLs that have changed. Something as simple as:<br class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207m_-8748275103433739441m_5598282663562434544gmail_msg m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg">
<br class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207m_-8748275103433739441m_5598282663562434544gmail_msg m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg">
| Former URL | Current URL |<br class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207m_-8748275103433739441m_5598282663562434544gmail_msg m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg">
|-----------------------------<wbr>------------------------------<wbr>------------------------------<wbr>---|--------------------------<wbr>------------------------------<wbr>------------------------------<wbr>----------|<br class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207m_-8748275103433739441m_5598282663562434544gmail_msg m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg">
| [a_random_pyplot_example](<a href="http://matplotlib.org/examples/api/a_random_pyplot_example.html" rel="noreferrer" class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207m_-8748275103433739441m_5598282663562434544gmail_msg m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg" target="_blank">http<wbr>://matplotlib.org/examples/api<wbr>/a_random_pyplot_example.html</a>) | [a_random_example_pyplot](<a href="http://matplotlib.org/examples/pyplot/a_random_pyplot_example.html" rel="noreferrer" class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207m_-8748275103433739441m_5598282663562434544gmail_msg m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg" target="_blank">http<wbr>://matplotlib.org/examples/pyp<wbr>lot/a_random_pyplot_example.ht<wbr>ml</a>) |<br class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207m_-8748275103433739441m_5598282663562434544gmail_msg m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg">
| ... | ... |<br class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207m_-8748275103433739441m_5598282663562434544gmail_msg m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg">
| [a_deleted_example_pyplot](<a href="http://matplotlib.org/examples/api/an_deprecated_example.html" rel="noreferrer" class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207m_-8748275103433739441m_5598282663562434544gmail_msg m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg" target="_blank">htt<wbr>p://matplotlib.org/examples/ap<wbr>i/an_deprecated_example.html</a>) | This example was deleted |<br class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207m_-8748275103433739441m_5598282663562434544gmail_msg m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg">
<br class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207m_-8748275103433739441m_5598282663562434544gmail_msg m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg">
which would then be referenced on the main page (maybe in the “Documentation” section, as the links for the previous docs.)<br class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207m_-8748275103433739441m_5598282663562434544gmail_msg m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg">
<br class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207m_-8748275103433739441m_5598282663562434544gmail_msg m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg">
My 2 cents,<br class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207m_-8748275103433739441m_5598282663562434544gmail_msg m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg">
Adrien<br class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207m_-8748275103433739441m_5598282663562434544gmail_msg m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg">
<br class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207m_-8748275103433739441m_5598282663562434544gmail_msg m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg">
Le 13/02/2017 à 06:20, Thomas Caswell a écrit :<br class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207m_-8748275103433739441m_5598282663562434544gmail_msg m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg">
> Folks,<br class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207m_-8748275103433739441m_5598282663562434544gmail_msg m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg">
><br class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207m_-8748275103433739441m_5598282663562434544gmail_msg m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg">
> The examples have been getting a lot of attention recently (much credit<br class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207m_-8748275103433739441m_5598282663562434544gmail_msg m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg">
> to Nelle who is leading that effort) which is great! However I am a bit<br class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207m_-8748275103433739441m_5598282663562434544gmail_msg m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg">
> worried about moving/renaming examples as it will break peoples bookmarks.<br class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207m_-8748275103433739441m_5598282663562434544gmail_msg m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg">
><br class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207m_-8748275103433739441m_5598282663562434544gmail_msg m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg">
> How much do we care about that (I may be being overly worried/cautious<br class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207m_-8748275103433739441m_5598282663562434544gmail_msg m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg">
> here)? What are our options for leaving bread-crumbs / forwards for people?<br class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207m_-8748275103433739441m_5598282663562434544gmail_msg m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg">
><br class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207m_-8748275103433739441m_5598282663562434544gmail_msg m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg">
> Tom<br class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207m_-8748275103433739441m_5598282663562434544gmail_msg m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg">
><br class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207m_-8748275103433739441m_5598282663562434544gmail_msg m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg">
><br class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207m_-8748275103433739441m_5598282663562434544gmail_msg m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg">
> ______________________________<wbr>_________________<br class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207m_-8748275103433739441m_5598282663562434544gmail_msg m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg">
> Matplotlib-devel mailing list<br class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207m_-8748275103433739441m_5598282663562434544gmail_msg m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg">
> <a href="mailto:Matplotlib-devel@python.org" class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207m_-8748275103433739441m_5598282663562434544gmail_msg m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg" target="_blank">Matplotlib-devel@python.org</a><br class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207m_-8748275103433739441m_5598282663562434544gmail_msg m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg">
> <a href="https://mail.python.org/mailman/listinfo/matplotlib-devel" rel="noreferrer" class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207m_-8748275103433739441m_5598282663562434544gmail_msg m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg" target="_blank">https://mail.python.org/mailma<wbr>n/listinfo/matplotlib-devel</a><br class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207m_-8748275103433739441m_5598282663562434544gmail_msg m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg">
><br class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207m_-8748275103433739441m_5598282663562434544gmail_msg m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg">
<br class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207m_-8748275103433739441m_5598282663562434544gmail_msg m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg">
______________________________<wbr>_________________<br class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207m_-8748275103433739441m_5598282663562434544gmail_msg m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg">
Matplotlib-devel mailing list<br class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207m_-8748275103433739441m_5598282663562434544gmail_msg m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg">
<a href="mailto:Matplotlib-devel@python.org" class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207m_-8748275103433739441m_5598282663562434544gmail_msg m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg" target="_blank">Matplotlib-devel@python.org</a><br class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207m_-8748275103433739441m_5598282663562434544gmail_msg m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg">
<a href="https://mail.python.org/mailman/listinfo/matplotlib-devel" rel="noreferrer" class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207m_-8748275103433739441m_5598282663562434544gmail_msg m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg" target="_blank">https://mail.python.org/mailma<wbr>n/listinfo/matplotlib-devel</a><br class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207m_-8748275103433739441m_5598282663562434544gmail_msg m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg">
</blockquote></div>
</div></div><br class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg">______________________________<wbr>_________________<br class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg">
Matplotlib-devel mailing list<br class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg">
<a href="mailto:Matplotlib-devel@python.org" class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg" target="_blank">Matplotlib-devel@python.org</a><br class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg">
<a href="https://mail.python.org/mailman/listinfo/matplotlib-devel" rel="noreferrer" class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg" target="_blank">https://mail.python.org/mailma<wbr>n/listinfo/matplotlib-devel</a><br class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg">
<br class="m_6742141918171814406m_-3292747440611279685m_2365971422235923207gmail_msg"></blockquote></div></div></div></blockquote></div>
</div></div></blockquote></div></div></div><br></div></div>
<br>______________________________<wbr>_________________<br>
Matplotlib-devel mailing list<br>
<a href="mailto:Matplotlib-devel@python.org" target="_blank">Matplotlib-devel@python.org</a><br>
<a href="https://mail.python.org/mailman/listinfo/matplotlib-devel" rel="noreferrer" target="_blank">https://mail.python.org/mailma<wbr>n/listinfo/matplotlib-devel</a><br>
<br></blockquote></div><br></div>
</div></div><br>______________________________<wbr>_________________<br>
Matplotlib-devel mailing list<br>
<a href="mailto:Matplotlib-devel@python.org">Matplotlib-devel@python.org</a><br>
<a href="https://mail.python.org/mailman/listinfo/matplotlib-devel" rel="noreferrer" target="_blank">https://mail.python.org/<wbr>mailman/listinfo/matplotlib-<wbr>devel</a><br>
<br></blockquote></div><br></div>