[Twisted-Python] Acronym Expansion in Documentation (WARNING: Newbie)
radix at twistedmatrix.com
Sun Oct 27 09:34:20 EST 2002
On Sat, Oct 26, 2002 at 02:34:37PM -0400, James Crayne wrote:
> Hello, I am a (brand spankin' new)-bie, and the documentation contains
> something that i tripped over.
> "The most prevalent kind of plug-in is the TAP (Twisted Application builder) type."
> On the first read, I stumbled. On the second, i thought maybe it's a missprint and
> tried to guess at what was really meant. The catch is that there is no capital P in
> this acronym expansion.
> Newbie think: "(Twisted Application _Pickle_ builder)?" or "Why isnt it called
> TAB? or TAb?" ...
Yeah, this has bothered me for a while; I'd personally like to rename
`mktap' to `mkapp', and save the acronym "tap" specifically for
"Twisted Application Pickle", but glyph doesn't seem to like that idea
<< radix at twistedmatrix.com >>
More information about the Twisted-Python