<div dir="ltr">I added it to the Further Reading section in <br><a href="https://www.mediawiki.org/wiki/Naming_things">https://www.mediawiki.org/wiki/Naming_things</a> ;-)<br></div><div class="gmail_extra"><br><div class="gmail_quote">On Mon, May 16, 2016 at 1:42 PM, Kevin Smith <span dir="ltr"><<a href="mailto:ksmith@wikimedia.org" target="_blank">ksmith@wikimedia.org</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div><div><div>I agree with most of that article. <br><br></div>In the section "Move Simple Comments Into Variable Names", I was surprised the author didn't mention the #1 reason to do so: It's too easy to forget to update a comment when the meaning of the variable changes. The later section "Use Longer OTVs to Explain Confusing Code" is another great example of clearer code reducing/eliminating the need a comment. <br><br></div>I'm not sold on avoiding cliches like "count" and "result", if you're  keeping idioms like "i" and "n". <br><br></div>Sidebar anecdote: In my second-ever paid programming job, we were forced to use only letter+digit variable names, like A2 and G6, because our (interpreted) program had to fit in 32K of RAM, and longer variable names would have consumed precious space. It was an awesome early lesson on the power of meaningful variable names. <br><div><br></div></div><div class="gmail_extra"><br clear="all"><div><div><div dir="ltr"><div><div dir="ltr"><div><div dir="ltr"><div><div dir="ltr"><span><font color="#888888"><br>Kevin Smith<br>Agile Coach, Wikimedia Foundation<br></font></span><font><font><i><font color="#888888"><br></font></i></font></font></div></div></div></div></div></div></div></div></div>
<br><div class="gmail_quote"><span class="">On Tue, May 3, 2016 at 4:24 AM, Filippo Giunchedi <span dir="ltr"><<a href="mailto:fgiunchedi@wikimedia.org" target="_blank">fgiunchedi@wikimedia.org</a>></span> wrote:<br></span><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span class=""><div dir="ltr"><div><a href="http://a-nickels-worth.blogspot.ie/2016/04/a-guide-to-naming-variables.html" target="_blank">http://a-nickels-worth.blogspot.ie/2016/04/a-guide-to-naming-variables.html</a><br></div><div><br></div><div>(full disclosure: from a former colleague)<br></div></div>
<br></span>_______________________________________________<br>
Engineering mailing list<br>
<a href="mailto:Engineering@lists.wikimedia.org" target="_blank">Engineering@lists.wikimedia.org</a><br>
<a href="https://lists.wikimedia.org/mailman/listinfo/engineering" rel="noreferrer" target="_blank">https://lists.wikimedia.org/mailman/listinfo/engineering</a><br>
<br></blockquote></div><br></div>
<br>_______________________________________________<br>
Engineering mailing list<br>
<a href="mailto:Engineering@lists.wikimedia.org">Engineering@lists.wikimedia.org</a><br>
<a href="https://lists.wikimedia.org/mailman/listinfo/engineering" rel="noreferrer" target="_blank">https://lists.wikimedia.org/mailman/listinfo/engineering</a><br>
<br></blockquote></div><br><br clear="all"><br>-- <br><div class="gmail_signature"><div dir="ltr"><div><div dir="ltr"><div><div dir="ltr"><div><div dir="ltr"><div><font size="2">Nick Wilson (Quiddity)<br>Community Liaison<br>Wikimedia Foundation</font></div></div></div></div></div></div></div></div></div>
</div>