Can you do something like 01Intro to force ordering here? I think it'll just majorly confuse users if they see advanced before intro.

yeah that's a good point @story645! The latest push has the ordering correct. It turns out that if you number the folders, they show up only in the URLs and not in the section headers, which is pretty cool!

This also consolidated some of the colormap examples into a colormap tutorial, which you can see here:

http://predictablynoisy.com/matplotlib/tutorials/colors/colormaps.html

Yay! Also now gonna ask for some sort of ordering so that pyplot and a simple OO tutorial (if there is one...I think the usage faq may also work...)come before customizing?

There's something weird going on with s-g (that i had noticed on my side some time ago). If you look at your build, the background of the "customizing matplotlib" entry is black instead of white. This seems to occur every once in a while (though not consistently), someone should probably check what's happening.

@story645 that one is actually harder to accomplish, but I think will be fixed eventually. see sphinx-gallery/sphinx-gallery#37

Basically sphinx gallery orders the examples w/in a folder by the number of lines of code. There's debate about the right way to handle this in that issue but I don't think we can do custom ordering for now. My solution was to use more folders w/ fewer examples so it doesn't get too cluttered.

@anntzer I believe that's intentional. That code block demos the use of one-off rcparams and it uses dark-background:

with plt.style.context((‘dark_background’)):
    plt.plot(np.sin(np.linspace(0, 2 * np.pi)), ‘r-o’)

:/ Then what about moving the gridspec and tight tutorials down to intermediate since the other module level tutorials are in that section?

@story645 this is fine with me...I think that gridspec is definitely not introductory material anyway. tight-layout I'm on the fence with but I think it's fine if it's in intermediate. new push coming.

I'm on the fence w/ tight layout too, so don't really mind if it ends up in whichever section ends up aesthetically making more sense.

@story645 see latest version in push and updated on my website. See new usage guide here!

http://predictablynoisy.com/matplotlib/tutorials/01_introductory/usage.html

😄 Thanks for going on the doc binge! This is so awesome!

@story645 the docs are gonna be so much better! :)

looks like tests are passing... and other changes you can think of for this PR @story645 ?

This is probably more of an open discussion type thing, but I wonder if external resources should go at the bottom of this page or even just get linked to from the top of this page.

@story645 for your comment about "advanced users" etc, do you mean to add that in the README.txt file for the advanced folder?

and regarding the external resources - my thinking is that we should move everything that is tutorial-style into the tutorials folder, and thus the user guide page will be a lot easier to parse because there will be fewer items in it. We should def. link to the user guide page from the tutorials and examples page though.

@story645 latest push has links to some other relevant parts of the documentation at the top of both the examples / tutorials. I think that was a good idea to make things more interconnected.

(it's ImageComparisonFailure) ;-)

I think I realized why we don't notice the sidebar! Traditionally it's on the left, so that's where we're all trained to look.

Yup, meant edit the READEME in advanced.

yep - that is definitely why I didn't notice it :)

PS, latest push fixes the labels so that they're all the default sphinx-gallery label instead of the custom ones that were used before. This means that all of the thumbnail descriptions should work now!

latest push just removes dempsy badge btw, the tests should be passing. LMK if there's anything else to do. I think this is ready to go from my end.