[Python-authors] Book writing software

[Aahz]

On Sat, Apr 20, 2013, Naomi Ceder wrote:
>
> No useful advice from me, just a caveat. The real pain point I've always
> felt is keeping code snippets current through testing and revision. I know
> that some people have been working on solutions to this issue. I can tell
> you that managing code when writing in something like Word is a total
> nightmare.

This was one of the main reasons I chose reST: I wrote a special include
directive that brought in both code and output.  (I.e. each example was
a separate external file.)
-- 
Aahz (aahz at pythoncraft.com)           <*>         http://www.pythoncraft.com/

"In theory, there is no difference between theory and practice.  But, in
practice, there is."  --Jan L.A. van de Snepscheut