[Twisted-Python] Lies, Damn Lies, and Stable Interfaces

[Jasper Phillips]

On Tue, 17 Jun 2003, Itamar Shtull-Trauring wrote:

> On Tue, 17 Jun 2003 22:54:16 +0300
> Tommi Virtanen <tv at twistedmatrix.com> wrote:
> 
> > 	Man. You need to let let *go* of that pipe. You've been
> > 	puffing a bit too much.
> 
> For the record, cred was designed by glyph and me. And we chose the
> names together, and they make a lot of sense, we didn't choose them
> (just) because they sound cool.

They're not egregious, but some aren't very good either -- no offense.  As is
often the case, the first names presented aren't the best ones; why not make
it standard procedure to first discuss better names when adding something new
to Twisted?

The names I suggest most need changing:
Mind:          ClientProxy instead?
Realm, Avatar: I think they're fine, as lone as a Realm also includes internal
               state as the name implies, rather than being a mere gatekeeper
               as the description seems to imply...

I look forward to using the new cred; it sounds much improved!
-Jasper