<div class="gmail_quote">On Wed, Jul 11, 2012 at 10:44 AM, Adam Klein <span dir="ltr">&lt;<a href="mailto:adamk@chromium.org" target="_blank">adamk@chromium.org</a>&gt;</span> wrote:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">

<div class="HOEnZb"><div class="h5">On Wed, Jul 11, 2012 at 9:51 AM, Ryosuke Niwa <span dir="ltr">&lt;<a href="mailto:rniwa@webkit.org" target="_blank">rniwa@webkit.org</a>&gt;</span> wrote:<br></div></div><div class="gmail_extra">

<div class="gmail_quote"><div><div class="h5"><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><div class="gmail_quote">

<div>On Wed, Jul 11, 2012 at 9:30 AM, Yaar Schnitman <span dir="ltr">&lt;<a href="mailto:yaar@chromium.org" target="_blank">yaar@chromium.org</a>&gt;</span> wrote:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">

[(dev time of maintaining comments) + (risk of outdated comments causing bugs X dev time of fixing resulting bugs)] &lt;&lt; (dev time gained by more contributors each being more knowledgable)<div><br></div><div>No?</div>

</blockquote><div><br></div></div><div>How did you reach such a conclusion? Do you have any data points to support that?</div></div></blockquote><div><br></div></div></div><div>Not sure about data points, but anecdotally I&#39;ve noticed it&#39;s common practice in WebKit to point newbies at particular contributors for explanations of how things work (e.g., &quot;oh, selection? that&#39;s tricky, ask rniwa&quot;). It seems plausible that some of the overhead of &quot;oral tradition&quot; could be reduced by judicious application of comments (as well as other written documentation, of course, like Dave Hyatt&#39;s blog posts and various wiki pages).</div>

</div></div></blockquote><div><br></div><div>As discussed on IRC, we can do that more appropriately on blog posts, technical articles, and wiki pages where we talk about the overall picture on how things fit/work together.</div>

<div><br></div><div>Selection, for example, is a very complicated beast and even I don&#39;t fully understand all the details even though I&#39;ve been almost exclusively working on editing and have touched the selection code on numerous occasions. To understand how selection works, one needs to understand several classes like FrameSelection, VisibleSelection, Position, VisiblePosition, and Range on top of a large amount of rendering code. For example, I&#39;ve been working on this blog post about bidi text selection for the past 2-3 months and I&#39;m not even half way done yet.</div>

<div><br></div></div><div class="gmail_quote">On Wed, Jul 11, 2012 at 10:47 AM, Per Bothner <span dir="ltr">&lt;<a href="mailto:per.bothner@oracle.com" target="_blank">per.bothner@oracle.com</a>&gt;</span> wrote:<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">


On 07/11/2012 09:51 AM, Ryosuke Niwa wrote:&gt; On Wed, Jul 11, 2012 at 9:30 AM, Yaar Schnitman &lt;<a href="mailto:yaar@chromium.org" target="_blank">yaar@chromium.org</a><div class="im">
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
How did you reach such a conclusion? Do you have any data points to<br>
support that?<br>
</blockquote>
<br></div>
It seems plausible.  I doubt we have any data points to support the<br>
opposite conclusion.</blockquote><div><br></div><div>I don&#39;t think anybody had claimed the opposite conclusion.</div><div><br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">

Given that, I would suggest it is better for an<br>
open-source project to err on the side of more public information<br>
(i.e. openness) rather than less.</blockquote><div><br></div><div>Let us not start name calling.</div><div><br></div><div>- Ryosuke</div><div><br></div></div>