How do you keep documentation so nice?

Stefan van der Walt stefan at sun.ac.za
Tue Dec 9 18:10:19 EST 2014


Hi Juan

On 2014-12-10 00:59:01, Juan Nunez-Iglesias <jni.soma at gmail.com> wrote:
> Huh??? You sent that link! LOL I was puzzled too but then saw the PR
> from the owner's "personal" fork of the repo, which I guess (no time
> to look at it yet) has a fair few resources.

This is where the project is supposed to be maintained--I am following
the discussions, and thought they just haven't committed any code.  Now
that I know differently I'll ask them to commit to that branch.

> 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

She "cheated" a bit and included an image from the gallery.

> 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?

In this case, yes.

Stéfan



More information about the scikit-image mailing list