<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
</head>
<body bgcolor="#FFFFFF" text="#000000">
<div class="moz-cite-prefix">On 6/11/2016 6:42 AM, R Kent James
wrote:<br>
<br>
While I am no developer, it has been a constant source of
irritation to me that the source so lacks documentation that it
is very difficult to get a handle on what actually goes on. This
is particularly from my perspective,but without documentation it
is difficult to determine if an action is a bug or intended. What
is the expected outcome is something I would like to see. So
anything that makes the code less daunting may also see more
contributors. I am all for it.<br>
<br>
Matt<br>
</div>
<blockquote type="cite"
cite="mid:89110100-f3bb-0a6f-9de8-ef7195e5385e@caspia.com">
<pre wrap=""> Anything that will make itAs I discuss various issues in bugs, I continually notice the lack of
documentation in so much of our internal code (Mozilla culture in
general does not support good code documentation per my standards, but
that is another issue. New code is routinely landed with no description
of the purpose of files or modules, for example).
Might I propose a new review rule, applying at least for anything under
c-c/mailnews and perhaps under other directories? That would be to allow
anyone who is a module owner or peer under c-c to provide a
documentation-only patch without review, landed with DONTBUILD? That way
we could reduce the friction in improving documentation. I actually
think there is a similar rule in existence in m-c Does anyone know that
rule and what is entered for r= or a= to allow it?
:rkent
_______________________________________________
tb-planning mailing list
<a class="moz-txt-link-abbreviated" href="mailto:tb-planning@mozilla.org">tb-planning@mozilla.org</a>
<a class="moz-txt-link-freetext" href="https://mail.mozilla.org/listinfo/tb-planning">https://mail.mozilla.org/listinfo/tb-planning</a>
</pre>
</blockquote>
<br>
<p><br>
</p>
<div class="moz-signature">-- <br>
“Against stupidity the gods themselves contend in vain.”
<i>― Friedrich von Schiller, Die Jungfrau von Orleans </i></div>
</body>
</html>