[Twisted-Python] Acronym Expansion in Documentation (WARNING: Newbie)

Christopher Armstrong 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
:-)

-- 
			Christopher Armstrong
		    << radix at twistedmatrix.com >>
	     http://twistedmatrix.com/users/radix.twistd/




More information about the Twisted-Python mailing list