No, I *really* disagree.  All of the techniques here are generic to matplotlib, and have no dependency on Iris or Cartopy, which is why I initially did not even mention the Iris forms of the plot functions, which @ajdawson then asked for  + you seemed doubtful of ..
> @ajdawson Perhaps you should also mention the iris versions, since this is an Iris example.
> > @dkillick We would typically only do that in a notebook as they have greater potential to not remain static. I'm not aware of any other gallery example that does this either...

In my experience, It has been a major education issue from the start of this project that most of our users do not appreciate which features come from which modules/projects, so I really don't want to add the tiniest part to that confusion.
I did raise the point on Monday that I was uncomfortable that this example had nothing specific to to Iris or Cartopy in it, but "it is just matplotlib".  But several people (@marqh @rhattersley -- and I think even yourself @dkillick ?) said there was nothing wrong with that.