On Wed, Mar 04, 2015 at 11:41PM, 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.
if readme.io would only be a "mirror" of real docs that issue will sorta go away, right? As no one would need to manage or change the site? > * 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? Yeah, that's an issue. I wonder if this can be solved by using some sort of MD plugin for Confluence or something, so the docs can be visible on ASF cwiki site? Cos
