[Twisted-Python] Acronym Expansion in Documentation (WARNING: Newbie)
Christopher Armstrong
radix at twistedmatrix.com
Sun Oct 27 07:34:20 MST 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
:-)
--
Christopher Armstrong
<< radix at twistedmatrix.com >>
http://twistedmatrix.com/users/radix.twistd/
More information about the Twisted-Python
mailing list