Again I'm against micro-commenting like this. I think python is expressive enough that these comments are obvious, and if we encourage this, there will be 1000 PRs like this; we have enough problem dealing with the substantive PRs.

@ruthgn, I am not trying to discourage you personally - I hope you keep submitting PRs. However, I would encourage you to find examples that would be confusing to someone with passing familiarity with numpy and Matplotlib i.e. the audience should be assumed to have at least read https://matplotlib.org/stable/tutorials/introductory/usage.html If we can't assume that level of knowledge, our docs will become very distracting with basic explanations.

@timhoffm had a reasonable set of guidelines here, but in particular: "... do not clutter the code with too many comments."

@jklymak, no problem. I appreciate the helpful feedback! Will submit PRs that are aligned with these expectations next time.