From tcaswell at gmail.com Tue Feb 7 09:09:29 2017 From: tcaswell at gmail.com (Thomas Caswell) Date: Tue, 07 Feb 2017 14:09:29 +0000 Subject: [Matplotlib-devel] 2017-02-06 phone call notes Message-ID: Folks, It was only my self and Ryan May (dopplershift). We primarily talked through reviewing PRs. Decided to adjust the algorithm for scaling the dash-patterns, see https://github.com/matplotlib/matplotlib/pull/8032 for the result of that discussion. This is a minor API break from 2.0, but I think it is fair to use 2.0.1 to clean up some rough edges (and bend sem-ver a bit). I have been going back and forth on using github handles vs names in listing who is on the call. I think I am going to settle on gh handle + the name you expose on your github profile. Please let me know if this is not acceptable to anyone. Tom -------------- next part -------------- An HTML attachment was scrubbed... URL: From nelle.varoquaux at gmail.com Thu Feb 9 18:25:23 2017 From: nelle.varoquaux at gmail.com (Nelle Varoquaux) Date: Thu, 9 Feb 2017 15:25:23 -0800 Subject: [Matplotlib-devel] Docathon: let's get excited about writing documentation! Message-ID: Hi Matplotlib team! As we've been hinting both on the gitter chanel and in the emails, some of us are involved in organizing a docathon. The goal is to try to have opensource developers focus on writing and improving documentation for one week! Some cities will be able to have a dedicated place for developers to meet, but most of it should happen remotely. I will be participating with the goal to improve Matplotlib's documentation. Both Thomas and Hannah will also participate. I was wondering if other people would be interested in participating: it can be first by just reviewing documentation related pull request this week or by actually working on improving our documentation. If other people are interested, we can set a list of goals both for us to focus on but also for new contributors to help us. Here are a couple of ideas. - integrate Nicolas Rougier's matplotlib tutorial to our documentation. I believe we have his permission to do this, but this might be worth checking. - re-organize a bit the website to have the tutorials more prominent. - finish the sphinx-gallery migration. If we all did 10 examples, it could easily be done during that week. - Set up sklearn's really cool tool to help review documentation related pull request. (I actually hope to have this done *before* the docathon). - (not doable in a week but overall better website organization) Any ideas and contributions welcome Cheers, N -------------- next part -------------- An HTML attachment was scrubbed... URL: From tcaswell at gmail.com Sat Feb 11 17:17:03 2017 From: tcaswell at gmail.com (Thomas Caswell) Date: Sat, 11 Feb 2017 22:17:03 +0000 Subject: [Matplotlib-devel] clearing 'request changes' review Message-ID: Folks, I propose the following: - if you would be happy with any other dev clearing the review leave a note saying so explicitly - the default (no note) is to not dismiss other devs reviews, but if there is otherwise consensus and the 'request changes' reviewer is non-responsive, it may be cleared (use your judgement folks!) - if you want to block merging until you re-review it, leave a note saying so. Tom -------------- next part -------------- An HTML attachment was scrubbed... URL: From tcaswell at gmail.com Mon Feb 13 00:20:55 2017 From: tcaswell at gmail.com (Thomas Caswell) Date: Mon, 13 Feb 2017 05:20:55 +0000 Subject: [Matplotlib-devel] moving examples Message-ID: Folks, The examples have been getting a lot of attention recently (much credit to Nelle who is leading that effort) which is great! However I am a bit worried about moving/renaming examples as it will break peoples bookmarks. How much do we care about that (I may be being overly worried/cautious here)? What are our options for leaving bread-crumbs / forwards for people? Tom -------------- next part -------------- An HTML attachment was scrubbed... URL: From vincent.adrien at gmail.com Mon Feb 13 02:32:00 2017 From: vincent.adrien at gmail.com (vincent.adrien at gmail.com) Date: Mon, 13 Feb 2017 08:32:00 +0100 Subject: [Matplotlib-devel] moving examples In-Reply-To: References: Message-ID: <6a42e270-ff8e-db44-b0a3-16dfcb2bddc8@gmail.com> Hi Thomas, I guess the less imaginative solution may be a simple page referencing the URLs that have changed. Something as simple as: | Former URL | Current URL | |--------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------| | [a_random_pyplot_example](http://matplotlib.org/examples/api/a_random_pyplot_example.html) | [a_random_example_pyplot](http://matplotlib.org/examples/pyplot/a_random_pyplot_example.html) | | ... | ... | | [a_deleted_example_pyplot](http://matplotlib.org/examples/api/an_deprecated_example.html) | This example was deleted | which would then be referenced on the main page (maybe in the ?Documentation? section, as the links for the previous docs.) My 2 cents, Adrien Le 13/02/2017 ? 06:20, Thomas Caswell a ?crit : > Folks, > > The examples have been getting a lot of attention recently (much credit > to Nelle who is leading that effort) which is great! However I am a bit > worried about moving/renaming examples as it will break peoples bookmarks. > > How much do we care about that (I may be being overly worried/cautious > here)? What are our options for leaving bread-crumbs / forwards for people? > > Tom > > > _______________________________________________ > Matplotlib-devel mailing list > Matplotlib-devel at python.org > https://mail.python.org/mailman/listinfo/matplotlib-devel > From jenshnielsen at gmail.com Mon Feb 13 02:46:30 2017 From: jenshnielsen at gmail.com (Jens Nielsen) Date: Mon, 13 Feb 2017 07:46:30 +0000 Subject: [Matplotlib-devel] moving examples In-Reply-To: <6a42e270-ff8e-db44-b0a3-16dfcb2bddc8@gmail.com> References: <6a42e270-ff8e-db44-b0a3-16dfcb2bddc8@gmail.com> Message-ID: 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 matplotlib.org/majorversion/examples/... 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 Jens On Mon, 13 Feb 2017 at 08:32 vincent.adrien at gmail.com < vincent.adrien at gmail.com> wrote: > Hi Thomas, > > I guess the less imaginative solution may be a simple page referencing the > URLs that have changed. Something as simple as: > > | Former URL | > Current URL > | > > |--------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------| > | [a_random_pyplot_example]( > http://matplotlib.org/examples/api/a_random_pyplot_example.html) | > [a_random_example_pyplot]( > http://matplotlib.org/examples/pyplot/a_random_pyplot_example.html) | > | ... > | > ... | > | [a_deleted_example_pyplot]( > http://matplotlib.org/examples/api/an_deprecated_example.html) | > This example was deleted > | > > which would then be referenced on the main page (maybe in the > ?Documentation? section, as the links for the previous docs.) > > My 2 cents, > Adrien > > Le 13/02/2017 ? 06:20, Thomas Caswell a ?crit : > > Folks, > > > > The examples have been getting a lot of attention recently (much credit > > to Nelle who is leading that effort) which is great! However I am a bit > > worried about moving/renaming examples as it will break peoples > bookmarks. > > > > How much do we care about that (I may be being overly worried/cautious > > here)? What are our options for leaving bread-crumbs / forwards for > people? > > > > Tom > > > > > > _______________________________________________ > > Matplotlib-devel mailing list > > Matplotlib-devel at python.org > > https://mail.python.org/mailman/listinfo/matplotlib-devel > > > > _______________________________________________ > Matplotlib-devel mailing list > Matplotlib-devel at python.org > https://mail.python.org/mailman/listinfo/matplotlib-devel > -------------- next part -------------- An HTML attachment was scrubbed... URL: From tcaswell at gmail.com Mon Feb 13 17:24:33 2017 From: tcaswell at gmail.com (Thomas Caswell) Date: Mon, 13 Feb 2017 22:24:33 +0000 Subject: [Matplotlib-devel] 2017-02-13 phone call notes Message-ID: Folks, Continuing to experiment with exactly how to do these notes Ryan May, Eric Firing, Thomas Caswell, Nelle Varoquaux ** [[mpl:8032]] - Nelle suggests we replace dots with _actually_ dotted (round dots) - Eric points out it was never super dotted Conclusions: - get rid of clipping - make the 'dotted' pattern square - adjust the rest of the patterns to scale for dropping clipping - make sure all default patterns are commensurate (2 '--' to 4 ':' to 1 '-.') Other comments - merge the loosening of the `grid.linestyle` rcparam to accept dash patterns for 2.0.1 - merge the 'loose' version of patterns for 2.1 - can get 'true dotted' with =dash_capstyle = 'round'= + =[.000001, 1.5]= as the dash pattern ** code for playing with dash patterns #+BEGIN_SRC python import matplotlib.pyplot as plt from cycler import cycler plt.ion() fig, ax = plt.subplots() patterns = cycler('dashes', [(1, 1), (1.1, 1.1), (1, 2), (1, 3)]) * cycler('lw', [1, 1.5, 2, 3, 7, 10]) plt.rcParams['lines.dash_capstyle'] = 'butt' for j, m in enumerate(patterns): ax.plot([0, 1], [100 - j, 100 - j], **m, label=(str(m))) ax.legend() #+END_SRC #+BEGIN_SRC python import matplotlib.pyplot as plt from cycler import cycler plt.ion() fig, ax = plt.subplots() patterns = cycler('lw', [1, 1.5, 2, 3, 7, 10]) * cycler('linestyle', ['--', ':', '-.']) plt.rcParams['lines.dash_capstyle'] = 'butt' for j, m in enumerate(patterns): ax.plot([0, 1], [100 - j, 100 - j], **m, label=(str(m))) ax.legend() #+END_SRC -------------- next part -------------- An HTML attachment was scrubbed... URL: From nelle.varoquaux at gmail.com Mon Feb 13 19:38:14 2017 From: nelle.varoquaux at gmail.com (Nelle Varoquaux) Date: Mon, 13 Feb 2017 16:38:14 -0800 Subject: [Matplotlib-devel] moving examples In-Reply-To: References: <6a42e270-ff8e-db44-b0a3-16dfcb2bddc8@gmail.com> Message-ID: > 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 > matplotlib.org/majorversion/examples/... 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 > 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. > > > Jens > > On Mon, 13 Feb 2017 at 08:32 vincent.adrien at gmail.com < > vincent.adrien at gmail.com> wrote: > >> Hi Thomas, >> >> I guess the less imaginative solution may be a simple page referencing >> the URLs that have changed. Something as simple as: >> >> | Former URL | >> Current URL >> | >> |----------------------------------------------------------- >> ---------------------------------|-------------------------- >> ----------------------------------------------------------------------| >> | [a_random_pyplot_example](http://matplotlib.org/examples/ >> api/a_random_pyplot_example.html) | [a_random_example_pyplot](http >> ://matplotlib.org/examples/pyplot/a_random_pyplot_example.html) | >> | ... >> | >> ... | >> | [a_deleted_example_pyplot](http://matplotlib.org/examples/ >> api/an_deprecated_example.html) | This >> example was deleted | >> >> which would then be referenced on the main page (maybe in the >> ?Documentation? section, as the links for the previous docs.) >> >> My 2 cents, >> Adrien >> >> Le 13/02/2017 ? 06:20, Thomas Caswell a ?crit : >> > Folks, >> > >> > The examples have been getting a lot of attention recently (much credit >> > to Nelle who is leading that effort) which is great! However I am a bit >> > worried about moving/renaming examples as it will break peoples >> bookmarks. >> > >> > How much do we care about that (I may be being overly worried/cautious >> > here)? What are our options for leaving bread-crumbs / forwards for >> people? >> > >> > Tom >> > >> > >> > _______________________________________________ >> > Matplotlib-devel mailing list >> > Matplotlib-devel at python.org >> > https://mail.python.org/mailman/listinfo/matplotlib-devel >> > >> >> _______________________________________________ >> Matplotlib-devel mailing list >> Matplotlib-devel at python.org >> https://mail.python.org/mailman/listinfo/matplotlib-devel >> > > _______________________________________________ > Matplotlib-devel mailing list > Matplotlib-devel at python.org > https://mail.python.org/mailman/listinfo/matplotlib-devel > > -------------- next part -------------- An HTML attachment was scrubbed... URL: From tcaswell at gmail.com Mon Feb 13 19:40:46 2017 From: tcaswell at gmail.com (Thomas Caswell) Date: Tue, 14 Feb 2017 00:40:46 +0000 Subject: [Matplotlib-devel] moving examples In-Reply-To: References: <6a42e270-ff8e-db44-b0a3-16dfcb2bddc8@gmail.com> Message-ID: yes, i will give access to anyone who wants. On Mon, Feb 13, 2017, 19:38 Nelle Varoquaux wrote: > > 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 > matplotlib.org/majorversion/examples/... 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 > > > 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. > > > > > Jens > > On Mon, 13 Feb 2017 at 08:32 vincent.adrien at gmail.com < > vincent.adrien at gmail.com> wrote: > > Hi Thomas, > > I guess the less imaginative solution may be a simple page referencing the > URLs that have changed. Something as simple as: > > | Former URL | > Current URL > | > > |--------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------| > | [a_random_pyplot_example]( > http://matplotlib.org/examples/api/a_random_pyplot_example.html) | > [a_random_example_pyplot]( > http://matplotlib.org/examples/pyplot/a_random_pyplot_example.html) | > | ... > | > ... | > | [a_deleted_example_pyplot]( > http://matplotlib.org/examples/api/an_deprecated_example.html) | > This example was deleted > | > > which would then be referenced on the main page (maybe in the > ?Documentation? section, as the links for the previous docs.) > > My 2 cents, > Adrien > > Le 13/02/2017 ? 06:20, Thomas Caswell a ?crit : > > Folks, > > > > The examples have been getting a lot of attention recently (much credit > > to Nelle who is leading that effort) which is great! However I am a bit > > worried about moving/renaming examples as it will break peoples > bookmarks. > > > > How much do we care about that (I may be being overly worried/cautious > > here)? What are our options for leaving bread-crumbs / forwards for > people? > > > > Tom > > > > > > _______________________________________________ > > Matplotlib-devel mailing list > > Matplotlib-devel at python.org > > https://mail.python.org/mailman/listinfo/matplotlib-devel > > > > _______________________________________________ > Matplotlib-devel mailing list > Matplotlib-devel at python.org > https://mail.python.org/mailman/listinfo/matplotlib-devel > > > _______________________________________________ > Matplotlib-devel mailing list > Matplotlib-devel at python.org > https://mail.python.org/mailman/listinfo/matplotlib-devel > > -------------- next part -------------- An HTML attachment was scrubbed... URL: From nelle.varoquaux at gmail.com Tue Feb 14 16:54:00 2017 From: nelle.varoquaux at gmail.com (Nelle Varoquaux) Date: Tue, 14 Feb 2017 13:54:00 -0800 Subject: [Matplotlib-devel] moving examples In-Reply-To: References: <6a42e270-ff8e-db44-b0a3-16dfcb2bddc8@gmail.com> Message-ID: On 13 February 2017 at 16:40, Thomas Caswell wrote: > yes, i will give access to anyone who wants. > > On Mon, Feb 13, 2017, 19:38 Nelle Varoquaux > wrote: > >> >> 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 >> matplotlib.org/majorversion/examples/... 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 >> >> >> 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. >> > 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. 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. If renaming, moving or deleting an example makes our life easier, I think we should go forward with that. My 2 cents, N > >> >> >> >> Jens >> >> On Mon, 13 Feb 2017 at 08:32 vincent.adrien at gmail.com < >> vincent.adrien at gmail.com> wrote: >> >> Hi Thomas, >> >> I guess the less imaginative solution may be a simple page referencing >> the URLs that have changed. Something as simple as: >> >> | Former URL | >> Current URL >> | >> |----------------------------------------------------------- >> ---------------------------------|-------------------------- >> ----------------------------------------------------------------------| >> | [a_random_pyplot_example](http://matplotlib.org/examples/ >> api/a_random_pyplot_example.html) | [a_random_example_pyplot](http >> ://matplotlib.org/examples/pyplot/a_random_pyplot_example.html) | >> | ... >> | >> ... | >> | [a_deleted_example_pyplot](http://matplotlib.org/examples/ >> api/an_deprecated_example.html) | This >> example was deleted | >> >> which would then be referenced on the main page (maybe in the >> ?Documentation? section, as the links for the previous docs.) >> >> My 2 cents, >> Adrien >> >> Le 13/02/2017 ? 06:20, Thomas Caswell a ?crit : >> > Folks, >> > >> > The examples have been getting a lot of attention recently (much credit >> > to Nelle who is leading that effort) which is great! However I am a bit >> > worried about moving/renaming examples as it will break peoples >> bookmarks. >> > >> > How much do we care about that (I may be being overly worried/cautious >> > here)? What are our options for leaving bread-crumbs / forwards for >> people? >> > >> > Tom >> > >> > >> > _______________________________________________ >> > Matplotlib-devel mailing list >> > Matplotlib-devel at python.org >> > https://mail.python.org/mailman/listinfo/matplotlib-devel >> > >> >> _______________________________________________ >> Matplotlib-devel mailing list >> Matplotlib-devel at python.org >> https://mail.python.org/mailman/listinfo/matplotlib-devel >> >> >> _______________________________________________ >> Matplotlib-devel mailing list >> Matplotlib-devel at python.org >> https://mail.python.org/mailman/listinfo/matplotlib-devel >> >> -------------- next part -------------- An HTML attachment was scrubbed... URL: From ben.v.root at gmail.com Tue Feb 14 17:25:37 2017 From: ben.v.root at gmail.com (Benjamin Root) Date: Tue, 14 Feb 2017 17:25:37 -0500 Subject: [Matplotlib-devel] moving examples In-Reply-To: References: <6a42e270-ff8e-db44-b0a3-16dfcb2bddc8@gmail.com> Message-ID: 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. On Tue, Feb 14, 2017 at 4:54 PM, Nelle Varoquaux wrote: > > > On 13 February 2017 at 16:40, Thomas Caswell wrote: > >> yes, i will give access to anyone who wants. >> >> On Mon, Feb 13, 2017, 19:38 Nelle Varoquaux >> wrote: >> >>> >>> 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 >>> matplotlib.org/majorversion/examples/... 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 >>> >>> >>> 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. >>> >> > 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. > > 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. > If renaming, moving or deleting an example makes our life easier, I think > we should go forward with that. > > My 2 cents, > N > > >> >>> >>> >>> >>> Jens >>> >>> On Mon, 13 Feb 2017 at 08:32 vincent.adrien at gmail.com < >>> vincent.adrien at gmail.com> wrote: >>> >>> Hi Thomas, >>> >>> I guess the less imaginative solution may be a simple page referencing >>> the URLs that have changed. Something as simple as: >>> >>> | Former URL | >>> Current URL >>> | >>> |----------------------------------------------------------- >>> ---------------------------------|-------------------------- >>> ----------------------------------------------------------------------| >>> | [a_random_pyplot_example](http://matplotlib.org/examples/api >>> /a_random_pyplot_example.html) | [a_random_example_pyplot](http >>> ://matplotlib.org/examples/pyplot/a_random_pyplot_example.html) | >>> | ... >>> | >>> ... | >>> | [a_deleted_example_pyplot](http://matplotlib.org/examples/ap >>> i/an_deprecated_example.html) | This >>> example was deleted | >>> >>> which would then be referenced on the main page (maybe in the >>> ?Documentation? section, as the links for the previous docs.) >>> >>> My 2 cents, >>> Adrien >>> >>> Le 13/02/2017 ? 06:20, Thomas Caswell a ?crit : >>> > Folks, >>> > >>> > The examples have been getting a lot of attention recently (much credit >>> > to Nelle who is leading that effort) which is great! However I am a >>> bit >>> > worried about moving/renaming examples as it will break peoples >>> bookmarks. >>> > >>> > How much do we care about that (I may be being overly worried/cautious >>> > here)? What are our options for leaving bread-crumbs / forwards for >>> people? >>> > >>> > Tom >>> > >>> > >>> > _______________________________________________ >>> > Matplotlib-devel mailing list >>> > Matplotlib-devel at python.org >>> > https://mail.python.org/mailman/listinfo/matplotlib-devel >>> > >>> >>> _______________________________________________ >>> Matplotlib-devel mailing list >>> Matplotlib-devel at python.org >>> https://mail.python.org/mailman/listinfo/matplotlib-devel >>> >>> >>> _______________________________________________ >>> Matplotlib-devel mailing list >>> Matplotlib-devel at python.org >>> https://mail.python.org/mailman/listinfo/matplotlib-devel >>> >>> > > _______________________________________________ > Matplotlib-devel mailing list > Matplotlib-devel at python.org > https://mail.python.org/mailman/listinfo/matplotlib-devel > > -------------- next part -------------- An HTML attachment was scrubbed... URL: From antony.lee at berkeley.edu Tue Feb 14 23:50:03 2017 From: antony.lee at berkeley.edu (Antony Lee) Date: Tue, 14 Feb 2017 20:50:03 -0800 Subject: [Matplotlib-devel] moving examples In-Reply-To: References: <6a42e270-ff8e-db44-b0a3-16dfcb2bddc8@gmail.com> Message-ID: I would favor accepting a one-time breakage (as others mentioned it's really not that bad), and start versioning the docs (redirect matplotlib.org to matplotlib.org/$latest_ver and so on). See also https://www.python.org/dev/peps/pep-0430/. 2017-02-14 14:25 GMT-08:00 Benjamin Root : > 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. > > On Tue, Feb 14, 2017 at 4:54 PM, Nelle Varoquaux < > nelle.varoquaux at gmail.com> wrote: > >> >> >> On 13 February 2017 at 16:40, Thomas Caswell wrote: >> >>> yes, i will give access to anyone who wants. >>> >>> On Mon, Feb 13, 2017, 19:38 Nelle Varoquaux >>> wrote: >>> >>>> >>>> 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 >>>> matplotlib.org/majorversion/examples/... 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 >>>> >>>> >>>> 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. >>>> >>> >> 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. >> >> 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. >> If renaming, moving or deleting an example makes our life easier, I think >> we should go forward with that. >> >> My 2 cents, >> N >> >> >>> >>>> >>>> >>>> >>>> Jens >>>> >>>> On Mon, 13 Feb 2017 at 08:32 vincent.adrien at gmail.com < >>>> vincent.adrien at gmail.com> wrote: >>>> >>>> Hi Thomas, >>>> >>>> I guess the less imaginative solution may be a simple page referencing >>>> the URLs that have changed. Something as simple as: >>>> >>>> | Former URL | >>>> Current URL >>>> | >>>> |----------------------------------------------------------- >>>> ---------------------------------|-------------------------- >>>> ----------------------------------------------------------------------| >>>> | [a_random_pyplot_example](http://matplotlib.org/examples/api >>>> /a_random_pyplot_example.html) | [a_random_example_pyplot](http >>>> ://matplotlib.org/examples/pyplot/a_random_pyplot_example.html) | >>>> | ... >>>> | >>>> ... | >>>> | [a_deleted_example_pyplot](http://matplotlib.org/examples/ap >>>> i/an_deprecated_example.html) | This >>>> example was deleted | >>>> >>>> which would then be referenced on the main page (maybe in the >>>> ?Documentation? section, as the links for the previous docs.) >>>> >>>> My 2 cents, >>>> Adrien >>>> >>>> Le 13/02/2017 ? 06:20, Thomas Caswell a ?crit : >>>> > Folks, >>>> > >>>> > The examples have been getting a lot of attention recently (much >>>> credit >>>> > to Nelle who is leading that effort) which is great! However I am a >>>> bit >>>> > worried about moving/renaming examples as it will break peoples >>>> bookmarks. >>>> > >>>> > How much do we care about that (I may be being overly worried/cautious >>>> > here)? What are our options for leaving bread-crumbs / forwards for >>>> people? >>>> > >>>> > Tom >>>> > >>>> > >>>> > _______________________________________________ >>>> > Matplotlib-devel mailing list >>>> > Matplotlib-devel at python.org >>>> > https://mail.python.org/mailman/listinfo/matplotlib-devel >>>> > >>>> >>>> _______________________________________________ >>>> Matplotlib-devel mailing list >>>> Matplotlib-devel at python.org >>>> https://mail.python.org/mailman/listinfo/matplotlib-devel >>>> >>>> >>>> _______________________________________________ >>>> Matplotlib-devel mailing list >>>> Matplotlib-devel at python.org >>>> https://mail.python.org/mailman/listinfo/matplotlib-devel >>>> >>>> >> >> _______________________________________________ >> Matplotlib-devel mailing list >> Matplotlib-devel at python.org >> https://mail.python.org/mailman/listinfo/matplotlib-devel >> >> > > _______________________________________________ > Matplotlib-devel mailing list > Matplotlib-devel at python.org > https://mail.python.org/mailman/listinfo/matplotlib-devel > > -------------- next part -------------- An HTML attachment was scrubbed... URL: From nelle.varoquaux at gmail.com Thu Feb 16 17:42:45 2017 From: nelle.varoquaux at gmail.com (Nelle Varoquaux) Date: Thu, 16 Feb 2017 14:42:45 -0800 Subject: [Matplotlib-devel] Announcing: Docathon, week of 6 March 2017 Message-ID: Hi everyone, As some of you already know, some of us are involved in the organization of a docathon. Several of us will be meeting up to sprint on documentation or documentation-related projects at Berkeley, New York and Seattle. If you are interested in joining us, either remotely or on campus, don't hesitate to join! Cheers, Nelle *What's a Docathon?* It's a week-long sprint where we focus our efforts on improving the state of documentation in the open-source and open-science world. This means writing better documentation, building tools, and sharing skills. *Who?s this for?* Anyone who is interested in improving the understandability, accessibility, and clarity of software! This might mean developers with a particular project, or individuals who would like to contribute to a project. You don?t need to use a specific language (though there will be many Python and R developers) and you don?t need to be a core developer in order to help out. *Where can I sign up?* Check out the *Docathon website* . You can sign up as a *participant* , *suggest a project* to work on, or sign up *to host your own* remote Docathon wherever you like. You don?t have to use a specific language - we?ll be as accommodating as possible! *When is the Docathon?* The Docathon will be held *March 6 through March 10*. For those coming to BIDS at UC Berkeley, on the first day we'll have tutorials about documentation and demos of documentation tools, followed by a few hours of hacking. During the middle of the week, we'll set aside a few hours each afternoon for hacking as a group at BIDS. On the last day, we'll have a wrap-up event to show off what everybody worked on. *Where will the Docathon take place?* There are a *few docathons being held simultaneously* , each with their own schedule. At Berkeley we'll have a physical presence at BIDS over the week, and we encourage you to show up for the hours we set aside for doc hacking. However, it is totally fine to work remotely; we will coordinate people via email/GitHub, too. *Where can I get more information?* Check out an updated schedule, list of tutorials, and more information at our website here: *bids.github.io/docathon* . *Contact* If you have any questions, open an issue on our *GitHub repo* . We look forward to hearing from you! Please feel free to forward this email to anyone who may be interested. We'd love for other institutions/groups to get involved. -------------- next part -------------- An HTML attachment was scrubbed... URL: From aufc at cock.li Sun Feb 19 13:08:25 2017 From: aufc at cock.li (aufc at cock.li) Date: Sun, 19 Feb 2017 19:08:25 +0100 Subject: [Matplotlib-devel] [PATCH] Use XDG config path on FreeBSD Message-ID: <86k28mqciu.fsf@cock.li> Hello Matplotlib-Devel, I would like to submit a patch that enables the use of XDG config directory on FreeBSD, which makes sense for regular users. The patch is trivial. Cheers, Adam -------------- next part -------------- A non-text attachment was scrubbed... Name: 0001-Use-XDG-config-path-on-FreeBSD.patch Type: text/x-diff Size: 1560 bytes Desc: not available URL: From rmay31 at gmail.com Sun Feb 19 13:55:39 2017 From: rmay31 at gmail.com (Ryan May) Date: Sun, 19 Feb 2017 11:55:39 -0700 Subject: [Matplotlib-devel] [PATCH] Use XDG config path on FreeBSD In-Reply-To: <86k28mqciu.fsf@cock.li> References: <86k28mqciu.fsf@cock.li> Message-ID: Adam, Thanks for the patch. Would it be possible for you to submit this as a Pull Request on GitHub: https://github.com/matplotlib/matplotlib ? Thanks, Ryan On Sun, Feb 19, 2017 at 11:08 AM, wrote: > Hello Matplotlib-Devel, > > I would like to submit a patch that enables the use of XDG config > directory on FreeBSD, which makes sense for regular users. > > The patch is trivial. > > Cheers, > Adam > > > > _______________________________________________ > Matplotlib-devel mailing list > Matplotlib-devel at python.org > https://mail.python.org/mailman/listinfo/matplotlib-devel > > -- Ryan May -------------- next part -------------- An HTML attachment was scrubbed... URL: From aufc at cock.li Sun Feb 19 14:44:41 2017 From: aufc at cock.li (aufc at cock.li) Date: Sun, 19 Feb 2017 20:44:41 +0100 Subject: [Matplotlib-devel] [PATCH] Use XDG config path on FreeBSD References: <86k28mqciu.fsf@cock.li> Message-ID: <86k28mnexi.fsf@cock.li> 2017-02-19 11:55 -0700, Ryan May : > Thanks for the patch. Would it be possible for you to submit this as a Pull > Request on GitHub: Hi Ryan, I would prefer not to do it, because I would have to configure GitHub account for that and I see no benefit to do that ATM. (Considering the triviality of the patch.) I decided to go the "patch over email" way, because it is documented in the Dev Guide [1] and it's simpler and easier for me than PR. It's also easy and simple for a commiter to apply the patch with: git am name-of-the.patch Please tell me if there are any problems with the pathc. Cheers, Adam [1] http://matplotlib.org/devel/gitwash/patching.html From rmay31 at gmail.com Mon Feb 20 14:35:44 2017 From: rmay31 at gmail.com (Ryan May) Date: Mon, 20 Feb 2017 12:35:44 -0700 Subject: [Matplotlib-devel] [PATCH] Use XDG config path on FreeBSD In-Reply-To: <86k28mnexi.fsf@cock.li> References: <86k28mqciu.fsf@cock.li> <86k28mnexi.fsf@cock.li> Message-ID: Adam, It's fine--PR is just easier for devs because it doesn't require anything except the web interface. Also, all additions to Matplotlib have to go through a PR at some point. Adrian took care of opening the PR, and it's already merged to the master branch: https://github.com/matplotlib/matplotlib/pull/8103 Thanks for the patch! Ryan On Sun, Feb 19, 2017 at 12:44 PM, wrote: > 2017-02-19 11:55 -0700, Ryan May : > > > Thanks for the patch. Would it be possible for you to submit this as a > Pull > > Request on GitHub: > > Hi Ryan, > > I would prefer not to do it, because I would have to configure GitHub > account for that and I see no benefit to do that ATM. (Considering the > triviality of the patch.) > > I decided to go the "patch over email" way, because it is documented in > the Dev Guide [1] and it's simpler and easier for me than PR. > > It's also easy and simple for a commiter to apply the patch with: > > git am name-of-the.patch > > > Please tell me if there are any problems with the pathc. > > Cheers, > Adam > > > [1] http://matplotlib.org/devel/gitwash/patching.html > > _______________________________________________ > Matplotlib-devel mailing list > Matplotlib-devel at python.org > https://mail.python.org/mailman/listinfo/matplotlib-devel > -- Ryan May -------------- next part -------------- An HTML attachment was scrubbed... URL: From tcaswell at gmail.com Mon Feb 20 19:47:38 2017 From: tcaswell at gmail.com (Thomas Caswell) Date: Tue, 21 Feb 2017 00:47:38 +0000 Subject: [Matplotlib-devel] reducing the size of the docs repo Message-ID: Folks, We deploy the webpage via https://github.com/matplotlib/matplotlib.github.com however the repository is currently ~6.5GB. I propose we shrink this by: - delete all of the beta/rc docs builds from 2.0 - delete all but the last version of A.B.x docs (and symlink the other versions to the last one - squash the whole repo to a single commit and force-push Going forward, pushing new docs would do the same thing (link + squash + force-push). Tom -------------- next part -------------- An HTML attachment was scrubbed... URL: From aufc at cock.li Tue Feb 21 06:00:27 2017 From: aufc at cock.li (aufc at cock.li) Date: Tue, 21 Feb 2017 12:00:27 +0100 Subject: [Matplotlib-devel] [PATCH] Use XDG config path on FreeBSD References: <86k28mqciu.fsf@cock.li> <86k28mnexi.fsf@cock.li> Message-ID: <86vas3n704.fsf@cock.li> 2017-02-20 12:35 -0700, Ryan May : > It's fine--PR is just easier for devs because it doesn't require anything > except the web interface. Also, all additions to Matplotlib have to go > through a PR at some point. OK, I'll keep it in mind. > Adrian took care of opening the PR, and it's already merged to the master > branch: https://github.com/matplotlib/matplotlib/pull/8103 Great, thank you for taking care of that. Adam