On 5/4/05, <b class="gmail_sendername">Glyph Lefkowitz</b> &lt;<a href="mailto:glyph@divmod.com">glyph@divmod.com</a>&gt; wrote:<div><span class="gmail_quote"></span><div><br>
</div><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">where do these helpful people come from for other projects?&nbsp;&nbsp;I would<br>estimate that Twisted has tens of thousands of users by now, but the
<br>community is still oddly silent.</blockquote><div><br>
My feeling is that a big part of the problem is that Twisted is so
darned obscure in places that most people don't feel up to the task.
Other - far, far lesser, of course - projects get enthusiastic help
because they are less complex and, well, mystical (for lack of a better
word) than Twisted.<br>
<br>
For example:<br>
<br>
1) I create a subclass of an existing Twisted class in order to add some helpful debugging.<br>
2) I run my code but... the debugging code is not being executed!<br>
3) But ... if that's the case, the code shouldn't even RUN!<br>
4) Aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa!!!!<br>
<br>
I had just such an experience. Grumpy, I was.<br>
<br>
But it illustrates the point: I'm no idiot (last I checked). But I
cannot explain how it is possible that the code even worked, and thus I
feel completely inadequate to the task of even STARTING to help with
documentation. Where should I start? If I can't explain the workings of
a ten-line web server, what hope do I have of providing accurate input
to documentation? <br>
</div></div><br>-- <br><br>Best,<br><br>&nbsp;&nbsp;&nbsp;&nbsp;Jeff<br>