<html><head><meta http-equiv="Content-Type" content="text/html charset=us-ascii"></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;">On Mar 16, 2014, at 1:48 PM, <a href="mailto:exarkun@twistedmatrix.com">exarkun@twistedmatrix.com</a> wrote:<br><div><br></div><div><blockquote type="cite"><span style="font-family: Menlo-Regular;">I know it's easier to start a fresh document (this time it'll work for sure!) but please consider that this strategy may actually not produce the best results (it may in fact be the strategy that produced the current state of affairs).</span></blockquote><br></div><div>I don't have a lot to comment on this but it really bears repeating.</div><div><br></div><div>This problem is also not unique to Twisted; see also <<a href="https://xkcd.com/927/">https://xkcd.com/927/</a>>.</div><div><br class="Apple-interchange-newline"><blockquote type="cite"><blockquote type="cite" style="font-family: Menlo-Regular; font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px;">It should assume that dev already got the code and has a common sense<br></blockquote><br style="font-family: Menlo-Regular; font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px;"><span style="font-family: Menlo-Regular; font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px; float: none; display: inline !important;">"common sense"? There is no such thing, sorry. This is sort of an irrelevant tangent but I couldn't help commenting on it.</span><br style="font-family: Menlo-Regular; font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px;"><blockquote type="cite" style="font-family: Menlo-Regular; font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px;">for contributing to open source projects: create branch, create patch,<br>use tickets, use IRC. read code, write tests etc<br></blockquote></blockquote></div><div><br></div><div>I think this tangent is actually totally relevant. Potential contributors to open source overall are a very diverse audience with a widely divergent backgrounds. Twisted, in particular, attracts an especially idiosyncratic group, because Twisted runs in a really wide array of environments and supports a really wide array of protocols. If you wanted to do the "normal thing" you'd be contributing to Django, not Twisted.</div><div><br></div><div>Also, keep in mind that for many developers, even today, Twisted is their <i>first</i> open source contribution experience. Therefore there's no particular reason to believe that they would have any idea how to submit patches, or write tests, or that those things are needed. It may make sense to make there be an easy way to skip over these basics, but they definitely need to be present.</div><br><div>-glyph</div></body></html>