ignite-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Alexey Goncharuk <alexey.goncha...@gmail.com>
Subject Re: Let's keep Apache Ignite docs up-to-date
Date Tue, 06 Mar 2018 08:44:25 GMT

Bumping up this discussion.

I have recently found out that we have this process for documenting new
releases [1] which looks quite ridiculous to me.

First, creating a copy of page with next-version suffix is inconvenient and
error-prone: the next-version page is not visible to anyone, moreover, all
suggested edits to current documentation will be lost after the page copy
is created. Second, the documentation changes should be transparent to
users, but now a regular user cannot even review upcoming changes until
they are granted a permission to see/edit hidden pages.

Unless we have very strong reasons to keep documentation on readme.io (by
strong I mean a feature that cannot be implemented using a VCS + doc
generator), I would at least spend some time piloting the 'keep docs in the
VCS' approach.


[1] https://cwiki.apache.org/confluence/display/IGNITE/How+to+Document

2017-11-02 10:07 GMT+03:00 Dmitry Pavlov <dpavlov.spb@gmail.com>:

> I don't like git docs idea, it will require to follow whole
> PR-review-process that requires long time. IMO it is odd work.
> If readme.io provides review process, I suggest to keep it as-is.
> чт, 2 нояб. 2017 г. в 9:57, Dmitriy Setrakyan <dsetrakyan@apache.org>:
> > On Wed, Nov 1, 2017 at 11:27 PM, Vladimir Ozerov <vozerov@gridgain.com>
> > wrote:
> >
> > > +1 for moving docs under Git provided that we find a way to update docs
> > > outside of AI release as it is possible now with readme.io.
> > >
> >
> > I am HUGE +1 for that. The whole problem is that we haven't found a way
> > yet. All I want is to update a page and have it commit to GIT and become
> > available to public right away. Does anyone know any tool that supports
> it?
> >

  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message