https://10377-1385122-gh.circle-artifacts.com/0/home/circleci/project/doc/build/html/gallery/pyplots/align_ylabels.html#sphx-glr-gallery-pyplots-align-ylabels-py

tbh I find the two big boxes on top a bit... too much. How did the Note box get introduced anyways? Can we get rid of that? I mean the page should start with its title, not with a note.

I didn't introduce that! sphinx-gallery maybe?

EDIT: WRT the second blue box, I think its justified - the new methods are much easier for most uses...

I'm proposing to remove that box.

I’d rather have See also sections below the code. Having it up the is like saying “I’ll show you how to do alignment, but first you should look at these alternative ways.

Then again the referenced method is the simpler more standard case, which should come first.

The best solution would be to rewrite the example: First show a simple ˋalign_ylabel()ˋ example, then show the current code in case someone needs more control.

But I do not necessarily require this as part of this PR. Mentioning ˋalign_ylabel()ˋ is an improvement already.

Well ok fair enough. On phone and can’t label but I agree that combining the examples is a better solution. So please don’t merge until I do that.

https://10508-1385122-gh.circle-artifacts.com/0/home/circleci/project/doc/build/html/gallery/pyplots/align_ylabels.html#sphx-glr-gallery-pyplots-align-ylabels-py

@timhoffm are the changes ok? If so, we can merge...

There seem to be a conflict, please backport manually

Not a big deal to bother w/ backport... Thanks@timhoffm!