> the rst files get compiled by Sphinx, during which the plots etc. get generated.
I don't actually understand the process of generating plots in the case of hand-written docs. E.g. this image embed by Emmanuelle:
https://github.com/scikit-image/scikit-image/blob/master/doc/source/user_guide/numpy_images.txt#L73
Is that generated from the code in the .rst file itself, or does she have to know (through non-automated means) that the auto-example produces the same image as is required in the rst?
Juan.