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?
-- Brane
