I am not a fan of putting the external toolkits under the same top-level heading. Maybe add a top-level "Third-party toolkits" section?

I not quite sure what you mean. Are you suggesting to move the page fromExternal Resources to a separate top level heading? That makes sense to me.

Yes, something like:

 - external resources - MPL API - Toolkits    - axes_gird1    - mplot3d    -  - Third-party extensions packages    - trendvis    - seaborn    - ..

👍

I think this should be ready for review. The branch athttp://jenshnielsen.github.io/matplotlib is updated with the result of building156cb7f

Uhm, pretty sure this isn't the result of your changes, but the logo/banner
at the top of the homepage is completely messed up for me. The text of
"matplotlib" is too large causing the "m" and the "b" to be cut off on
either end the radar chart logo to be right on top of it.

Using Firefox 43 on Ubuntu.

On Tue, Dec 29, 2015 at 9:12 AM, Jens Hedegaard Nielsen <
notifications@github.com> wrote:

I think this should be ready for review. The branch at
http://jenshnielsen.github.io/matplotlib is updated with the result of
building156cb7f
156cb7f

—
Reply to this email directly or view it on GitHub
#5752 (comment)
.

@WeatherGod Is that any different fromhttp://matplotlib.org/devdocs/?

No, it is the same on both pages.

On Tue, Dec 29, 2015 at 9:41 AM, Jens Hedegaard Nielsen <
notifications@github.com> wrote:

@WeatherGodhttps://github.com/WeatherGod Is that any different from
http://matplotlib.org/devdocs/?

—
Reply to this email directly or view it on GitHub
#5752 (comment)
.

It's probably due to#5653 then?

as for the mpl_toolkits page itself:
http://jenshnielsen.github.io/matplotlib/mpl_toolkits/index.html, it feels
like there is too much redundant stuff. For example, there is the "mplot3d"
section header, then there is the "mplot3d" bullet point, and then the
"Matplotlib mplot3d toolkit" sub-bullet point. The axes_grid1 and
axisartist stuff isn't too bad, but still feels a little redundant.

On Tue, Dec 29, 2015 at 9:12 AM, Jens Hedegaard Nielsen <
notifications@github.com> wrote:

I think this should be ready for review. The branch at
http://jenshnielsen.github.io/matplotlib is updated with the result of
building156cb7f
156cb7f

—
Reply to this email directly or view it on GitHub
#5752 (comment)
.

Most likely, I have posted a comment there.

On Tue, Dec 29, 2015 at 9:44 AM, Jens Hedegaard Nielsen <
notifications@github.com> wrote:

It's probably due to#5653
#5653 then?

—
Reply to this email directly or view it on GitHub
#5752 (comment)
.

@WeatherGod I agree that it's a bit redundant but I have not actually changed that around. That is as it has always been.

But perhaps we should just remove all the TOCs from that page?

Oops -- sorry, I missed that this is still a WIP and the text hasn't been edited. I'll hold off on my grammatical/typographical nitpicks until that's done.

Is not WIP any more but by the looks of it most of the typos are in the original text which I have just moved.

I see. Should we try to fix those now anyway? I'm happy to just do them as a PR against this one if that's more efficient...

We might as well fix obvious typos now. I have tried not to do to many heavy edits but most of the examples could definitely need an edit but the question is how much effort we want to put into this part of the code?

I'll spend a few minutes (but no more) fixing obvious typos and submit a PR against this one...

Actually, now that I'm understanding the size of this better, I think it's probably best to leave the text as-is for this PR and try to clean it up later. (We really need to devote some real effort to editing the docs for grammar/consistency in a lot of places...)

@WeatherGod I have removed the toc trees

@mdboom I corrected the typos that you already noted and added a note above the matplotlib organization to thirdpartypackages/index

I have added an api changes noted thataxes_grid is deprecated.

The few files which were different inaxes_grid have been copied toaxisartist
They are mainly Axes fromaxes_grid but usingaxisartist axis. This should really be refactored away to make the Axes take an axis type on construction.

Has the github.io been updated for the latest changes?

On Wed, Dec 30, 2015 at 7:46 AM, Jens Hedegaard Nielsen <
notifications@github.com> wrote:

I have added an api changes noted that axes_grid is deprecated.

The few files which were different in axes_grid have been copied to
axisartist
They are mainly Axes from axes_grid but using axisartist axis. This
should really be refactored away to make the Axes take an axis type on
construction.

—
Reply to this email directly or view it on GitHub
#5752 (comment)
.

I have uploaded a new preview version tohttp://jenshnielsen.github.io/matplotlibdocs rather thanhttp://jenshnielsen.github.io/matplotlib

I think this should be ready to go. The documentation is by no means perfect but I think this is a significant structural improvement.

By the way. I'm happy to revet the deprecation ofaxes_grid and just change the docs in this PR

I think that's all the typos I can find. I vote for deprecation of axes_grid. It has been a long time coming, and splitting axisartist out in the documentation makes things a lot more understandable.

This has a +1 from me. Should this be backported to v2.x or should it stay in master?

I was not planning to backport it to 2.x but I can be convinced otherwise. Any objections to merging this. It moves around a large number of examples so I would like to merge it before it acquires to many conflicts.

ok, we will leave it in master for now