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 pull request currently.
As someone with commit access, even if we lifted all requirements to
file bugs, get reviews etc from the process, I'd still find the overhead
of contributing to in-tree documentation too high personally unless if
my contribution was something I would really consider "worth it". I
think moving docs into the tree will exclude the kind of casual
contributor who doesn't even know how to bypass all of our process to
get their contribution "accepted". Compare this to the current world
where they don't need to ask for anyone's blessing beforehand in the
first place. :-/
[1]: http://www.yesodweb.com/blog/2015/08/thoughts-on-documentation
- Ryan
On Fri, Jun 16, 2017 at 10:05 AM, Sylvestre Ledru
<sylves...@mozilla.com <mailto:sylves...@mozilla.com>> wrote:
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 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 needs to use the whole heavyweight process.
> And if we can make these things auto-DONTBUILD, that's even
better, of
> course.
>
> I agree it's still slower than a wiki. :(
And far from trivial for volunteers who just want to fix one or two
things in the doc :/
S
_______________________________________________
dev-builds mailing list
dev-builds@lists.mozilla.org <mailto:dev-builds@lists.mozilla.org>
https://lists.mozilla.org/listinfo/dev-builds
<https://lists.mozilla.org/listinfo/dev-builds>
_______________________________________________
dev-builds mailing list
dev-builds@lists.mozilla.org
https://lists.mozilla.org/listinfo/dev-builds
_______________________________________________
dev-builds mailing list
dev-builds@lists.mozilla.org
https://lists.mozilla.org/listinfo/dev-builds
