Re: Builds docs on MDN

2017-06-16 Thread Ehsan Akhgari
On 06/16/2017 11:22 AM, J. Ryan Stinnett wrote: The post goes on to suggest in-tree documentation kept up to date via pull requests as the better approach. I guess the trouble is that at least for mozilla-central, there isn't really a low barrier approach to submitting an in-tree change like a

Re: Builds docs on MDN

2017-06-16 Thread J. Ryan Stinnett
I am not sure if the reasoning applies to a community as large as Mozilla, but lately I've heard that new contributors can view a project wiki very differently from those heavily involved in a project. Copying directly from a blog post[1] on this topic: --- - Maintainers believe they're s

Re: Builds docs on MDN

2017-06-16 Thread Andreas Tolfsen
Also sprach Sylvestre Ledru: Le 16/06/2017 à 16:40, Boris Zbarsky a écrit : I believe we should not require filing bugs, reviews, or any of that for in-tree docs. Just edit the doc, commit, push. Add "r=documentation" if needed to placate hooks. Just because it's in-tree doesn't mean it nee

Re: Builds docs on MDN

2017-06-16 Thread Sylvestre Ledru
Le 16/06/2017 à 16:40, Boris Zbarsky a écrit : > On 6/16/17 9:33 AM, Ehsan Akhgari wrote: >> I certainly feel like the >> barrier for filing bugs, creating a patch, figuring out how to use >> readthedocs infrastructure, getting reviews, etc. isn't really worth it > > I believe we should not requi

Re: Builds docs on MDN

2017-06-16 Thread Boris Zbarsky
On 6/16/17 9:33 AM, Ehsan Akhgari wrote: I certainly feel like the barrier for filing bugs, creating a patch, figuring out how to use readthedocs infrastructure, getting reviews, etc. isn't really worth it I believe we should not require filing bugs, reviews, or any of that for in-tree docs.

Re: Builds docs on MDN

2017-06-16 Thread Mike Hoye
On 6/15/17 3:41 PM, Gregory Szorc wrote: We already had fragmented Firefox build docs. We have things scattered between MDN, wiki.mozilla.org , in-tree Sphinx docs, and years of mailing list and blog posts (which sadly are the sole source of some useful info). With MD

Re: Builds docs on MDN

2017-06-16 Thread Ehsan Akhgari
FWIW most of my contributions to the documentation hosted on MDN were in the form of casual edits here and there to pages, mostly in the form of me noticing something wrong in some documentation and quickly editing the wiki to fix it. The editing process of the MDN wiki was (well, still is!) e

Re: Builds docs on MDN

2017-06-16 Thread Andreas Tolfsen
Also sprach Andrew Halberstadt: On Fri, Jun 16, 2017 at 4:33 AM, Sylvestre Ledru wrote: As most of the people don't like to spend time writing docs, I am a bit concerned that using in-tree docs with our "heavy" review process (bug, reviewers, etc) will even decrease our contributions to the d

Re: Builds docs on MDN

2017-06-16 Thread Andrew Halberstadt
On Fri, Jun 16, 2017 at 4:33 AM, Sylvestre Ledru wrote: > As most of the people don't like to spend time writing docs, I am a bit > concerned that using in-tree docs with our "heavy" review process (bug, > reviewers, etc) will even decrease our contributions to the doc (instead of > the MDN wiki

Re: Builds docs on MDN

2017-06-16 Thread Sylvestre Ledru
Le 15/06/2017 à 22:22, Gregory Szorc a écrit : > On Thu, Jun 15, 2017 at 1:04 PM, Andrew Halberstadt > mailto:ahalberst...@mozilla.com>> wrote: > > +1 to preferring in-tree docs. > > If we're going to be adding a ton of new docs though, I think it > would be worth exploring a differen