[Twisted-Python] Woven example for article, Part II

[david mertz]

On Thu, 29 May 2003, david mertz <ibook at gnosis.cx> wrote:
 > To Andrew, and generally: I have installed a local copy of 1.0.5, and
 > that at least makes the PicturePile example work (there are a few
 > minor errors in the samples, but straightforward to fix)

Moshe Zadka wrote:
|There is a reason the documentation comes with the package:
|it is relevant to the version it comes with. In particular, the
|documentation on tm.com is only relevant to "latest stable". This is
|just like Python: if you read documentation from 
|http://www.python.org/doc/current/, don't count on it working with 
|Python 2.1.

This is very unhelpful, Moshe.  The documentation on the Twisted website
(as mentioned in my earlier note), unlike most Python standard
documentation, does not indicate in which versions the examples work
(PicturePile, specifically).  Nothing like "new in 1.0.4".  Moreover,
the errors did not make it obvious there was a version issue (and in any
case, the example still needed some minor corrections to work with
1.0.5).  Andrew's advice (and some by email) was helpful, but it was
hardly obvious a priori what the issue was.

Moreover, I have not encountered any change log that addresses woven 
version differences in any detail.  Quite possibly there is such a 
document, but I do not now know where it is.

None of this, btw., means to demean Twisted itself.  I do think it could 
use a bit more directed documentation, but the concept and subpackages 
themselves seem very useful and well conceived.

Yours, David...