[Twisted-Python] typos
Glyph Lefkowitz
glyph at twistedmatrix.com
Mon Jun 9 18:56:20 MDT 2003
On Monday, June 9, 2003, at 08:47 PM, Andrew Bennetts wrote:
> I agree; this is an excellent idea. Far too often we've said "but the
> docs
> in the next release will be much better, so get CVS or wait for
> 1.0.xx"...
I disagree. We say this about functionality as well, and CVS docs
should have parity with CVS code, not released code. (In other words -
if you want CVS docs, download CVS code.) The real problem is that we
don't release often enough - we should be fixing that, not applying
band-aids.
> I think it would be too much effort to update the API docs
> automatically;
I do agree here. This creates useless friction. We should probably
have another pass at automating release-oriented tasks, or at least
documenting the procedure better. doc/howto/release looks pretty dusty.
More information about the Twisted-Python
mailing list