<div dir="ltr">Hi all,<br><br>I'd like to comment on the contributor-specific arguments made in Benjamin's article, which seem to be:<br><br>- contributors struggle because of the module structure and poor APIs;<br>- contributors ask for better docs, but the docs are unavoidably bad because the APIs are bad.<br><br>TL;DR: I think the bigger problem is poor docs, not poor APIs.<br><br>I'm a webdev, like many of our contributors. I work on the Test Pilot team, where I've gotten a crash course in Gecko / addon development over the past 1.5 years, starting with building the Universal Search addon.<br><br>I'm used to working with a variety of less-than-perfect, evolving, overlapping APIs; that's the Web Platform that webdevs know and love. Inelegance is no barrier to contributing.<br><br>However, I'm also accustomed to having good learning resources: blog posts, examples, API docs, and, if all else fails, a carefully-worded spec. And this is where we, at Mozilla, fall short.<br><br>I've personally found that the XPCOM interfaces make sense, but I generally have to read a *lot* of source code to learn how to use them.<br><br>Insofar as the WebExtension API proposal is intended to make life better for contributors, I'd suggest investing in the docs instead.<br><br>Cheers,<br><br>Jared<br></div><div class="gmail_extra"><br><div class="gmail_quote">On Mon, Oct 10, 2016 at 2:27 PM, Emma Humphries <span dir="ltr"><<a href="mailto:emma@mozilla.com" target="_blank">emma@mozilla.com</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 class="gmail_extra"><span class=""><br><div class="gmail_quote">On Mon, Oct 10, 2016 at 1:52 PM, Richard Newman <span dir="ltr"><<a href="mailto:rnewman@mozilla.com" target="_blank">rnewman@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">IMO it's a mistake to treat all interfaces as equal and public, which seems to be the point of the WE side of this discussion.</blockquote></div><br></span><div style="font-family:arial,helvetica,sans-serif;display:inline" class="gmail_default">​My experience has been with building front-end applications, and I can't say that it maps to WebExtensions.<br><br>But this conversation reminded me of SoundCloud's talk at the 2013 HTML5Conf on the pain of building your application on your public API, and it captures some of the problems we ran into when we tried rewriting WhiteHat's reporting tools on top of our public rest API.<br><br><a href="https://www.youtube.com/watch?v=W8B9xT1QRb0" target="_blank">https://www.youtube.com/watch?<wbr>v=W8B9xT1QRb0</a>​</div>​</div></div>
<br>______________________________<wbr>_________________<br>
firefox-dev mailing list<br>
<a href="mailto:firefox-dev@mozilla.org">firefox-dev@mozilla.org</a><br>
<a href="https://mail.mozilla.org/listinfo/firefox-dev" rel="noreferrer" target="_blank">https://mail.mozilla.org/<wbr>listinfo/firefox-dev</a><br>
<br></blockquote></div><br></div>