[SciPy-Dev] Understanding source of docs, source file ".py" or ".rst" file

Skipper Seabold jsseabold at gmail.com
Tue Jun 29 11:06:23 EDT 2010


On Tue, Jun 29, 2010 at 3:55 AM, Pauli Virtanen <pav at iki.fi> wrote:
> Mon, 28 Jun 2010 23:04:39 -0500, Skipper Seabold wrote:
> [clip]
>> I also struggled to understand this at first.  Is this documented
>> somewhere?  If not, where would be best?  I'm thinking somewhere on the
>> main docs page.  I don't know that the Question and Answers page is
>> obvious enough.  Would the "before you start" be a good place?
>
> If you think about how Sphinx works, all this becomes clear. But perhaps
> it should be explicitly explained somewhere.
>

Yeah, it's clear(er) now. If the idea is to keep the barrier of entry
low to work on the wiki docs, then a few sentences on how this works
might be worth it.

Skipper



More information about the SciPy-Dev mailing list