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,