On 04.03.2015 23:41, Branko Čibej wrote: > On 04.03.2015 23:33, Konstantin Boudnik wrote: >> On Wed, Mar 04, 2015 at 02:22PM, Dmitriy Setrakyan wrote: >>> On Wed, Mar 4, 2015 at 2:20 PM, Konstantin Boudnik <[email protected]> wrote: >>> >>>> On Wed, Mar 04, 2015 at 02:18PM, Dmitriy Setrakyan wrote: >>>>> readme.io is a very cool documentation platform which gives free web >>>>> hosting, versioning, and sexy looks to open source projects, including >>>>> Apache projects. It stores documentation in a regular markdown format, >>>> and >>>>> I will add the MD files to the GIT tree before doing the next release. >>>> This >>>>> way readme.io will be the copy of the documentation stored in github. I >>>> You meant 'stored in Apache git", didn't you? >>>> >>> Yes, the Apache git. >> It seems to be satisfactory solutio as far as we keep the original docs >> source >> in Apache, no? > > There are a couple open questions here: > > * While all committers can update the docs, all committers should > also be able to manage the readme.io site. AFAIK there's no > automated way to achieve that, and no documented way for adding > site administrators. That's kind of a bad start. > * Readme.io is the /only/ online source of the docs, apparently. The > Incubator site links there, and there's no other way to see the > docs short of checking out the source. So ... what if readme.io > goes away? >
That's beside the fact that "Fork me on GitHub" is really a very bad suggestion. It's better to get people involved on the dev@ (and later users@) lists than to encourage them to throw-and-forget patches at the project through GitHub pull requests (which are, frankly, one of the more onerous ways for contributing to a project). -- Brane
