<div dir="ltr"><div class="gmail_extra"><div class="gmail_quote">On Thu, Jul 7, 2016 at 2:31 PM, Eric Shepherd <span dir="ltr"><<a href="mailto:eshepherd@mozilla.com" target="_blank">eshepherd@mozilla.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
<div text="#000000" bgcolor="#FFFFFF">It may be worth
considering deprecating the build docs on MDN in that situation, since
we increasingly rely on the dev team to maintain them anyway.<br><br></div></blockquote><div><br></div><div>I generally support this. From my experience, most of the build docs on MDN are out-of-date or were just plain wrong to begin with. There are several reasons for this. One is build system maintainers generally don't search MDN when writing patches because it adds too much overhead. We do have in-tree docs. However, even those aren't always up to date. And, they aren't as easy to update as a wiki. I even wrote an entire blog post on this topic 1.5 years ago: <a href="http://gregoryszorc.com/blog/2015/01/09/firefox-contribution-process-debt/">http://gregoryszorc.com/blog/2015/01/09/firefox-contribution-process-debt/</a><br><br></div><div>I like the idea of the "getting started" guide living on the wiki. I like the idea of lower-level technical details living in-tree because there are higher chances that build peers will ensure they are correct. I don't know where to draw the line or how to police the wiki for "bad" content :/<br></div><div><br></div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div text="#000000" bgcolor="#FFFFFF"><span><div><hr><span><font face="Tahoma" color="#000000"><b>From:</b>
Gregory Szorc</font></span><br><span><font face="Tahoma" color="#000000"><b>Sent:</b> Wednesday, Jun 8, 2016 12:40:13 PM EDT</font></span><br><span><font face="Tahoma" color="#000000"><b>To:</b> Mike Hoye</font></span><br><span><font face="Tahoma" color="#000000"><b>Cc:</b> Firefox Dev</font></span><br><span><font face="Tahoma" color="#000000"><b>Subject:</b> Dropping support for
VS2013</font></span><br><br></div></span><span class=""><blockquote style="border:medium none!important;margin-left:0px!important;margin-right:0px!important;margin-top:0px!important;padding-left:0px!important;padding-right:0px!important" type="cite"><blockquote type="cite" style="border:medium none!important;margin-left:0px!important;margin-right:0px!important;margin-top:0px!important;padding-left:0px!important;padding-right:0px!important">Who
is responsible for updating our build documentation about this?
<br></blockquote>Sorted, thanks. I don't see MDN "needs update"
notifications, so if you
find any other build docs drifting away from true just email me the
link.
</blockquote><br></span><span class=""><font color="#888888"><div>-- <br><br>
Eric Shepherd<br>
Senior Technical Writer<br>
<a href="https://developer.mozilla.org/" target="_blank">Mozilla Developer Network</a><br>
Blog: <a href="https://www.bitstampede.com/" target="_blank">https://www.bitstampede.com/</a><br>
Twitter: <a href="http://twitter.com/sheppy" target="_blank">http://twitter.com/sheppy</a><br>
Doodle: <a href="http://doodle.com/the.sheppy" target="_blank">http://doodle.com/the.sheppy</a><br>
<br>
</div></font></span></div>
</blockquote></div><br></div></div>