Re: [Python-authors] Python-authors Digest, Vol 26, Issue 2

2014-02-24 Thread Doug Hellmann
I put the code in separate files from the reST and then use cog with sphinx to run the scripts and insert the output. That lets me commit the output to source control with the rest of the document, to catch changes between builds (I found a regression in a Python standard library module that way

Re: [Python-authors] Python-authors Digest, Vol 26, Issue 2

2014-02-23 Thread Varied Thoughts
Hi all, I'm just about to put my first draft into some structure. It's in markdown-ish. I'd like to know more about the test scripts used. What are people using? Do you insert code an output into doc during make? Or extract code out of markdown somehow to run and test? Are you inserting the ou