id	summary	reporter	owner	description	type	status	priority	milestone	component	resolution	keywords	cc	branch	branch_author	launchpad_bug
4761	"Server documentation should use explicit buildProtocol()s rather than magic ""protocol = MyProtocol"" on factories"	itamar	itamar	"Observation at the Twisted Lab in Boston suggests that buildProtocol as an important protocol/factory integration point is hard for new users to understand. This seems to be at least in part because the documentation tends to use the ""protocol = MyProtocol"" shortcut, which is basically magic and hides the existence buildProtocol from new developers.

All uses of factories in our documentation ought to use an explicit buildProtocol. The client and server howtos should document ""protocol = MyProtocol"" (but not use it otherwise).
"	defect	closed	normal		core	fixed	documentation	jesstess	branches/explicit-buildProtocol-4761	itamarst