[RFC] Some clarifications for plotting code

Open Darryl Green requested to merge github/fork/bjackman/plot-clarifications into master

Created by: bjackman

I've been confused a few times while using the plotting code. This is a set of docstrings and cleanups that I made while trying to understand it. I've marked this RFC because:

  • it's very likely some of the stuff I've added is wrong or belongs somewhere else (i.e. it needs careful review from people who properly understand the code)
  • Some of it is a bit subjective

So I guess consider this low-priority :)

Merge request reports