Hi Pavel, The lack of smooth versioning between pages on readme.io <http://readme.io/> is redeemed with an easy to use editor. A doc writer don’t need to grasp any markup language, commit changes to some remote repo and check up final results. All the writer needs to do is to open a page and update it seeing the changes immediately.
Github is also a third-party site, so the docs won’t be hosted on ASF infrastructure anyway. As a the one who prepares docs frequently, I can live with readme.io <http://readme.io/>. — Denis > On Oct 31, 2017, at 2:35 AM, Pavel Tupitsyn <ptupit...@apache.org> wrote: > > Hi Denis, > > Are there plans to move away from readme.io? > > * It is not properly versioned, which is very painful > * Documentation should be in Apache git, not on some third party site > > Thoughts? > > On Mon, Oct 30, 2017 at 11:24 PM, Denis Magda <dma...@apache.org> wrote: > >> Good point. Renamed: >> https://cwiki.apache.org/confluence/display/IGNITE/How+to+Document < >> https://cwiki.apache.org/confluence/display/IGNITE/How+to+Document> >> >> — >> Denis >> >>> On Oct 30, 2017, at 12:37 PM, Dmitriy Setrakyan <dsetrak...@apache.org> >> wrote: >>> >>> Thanks Denis! Any change we can rename the page to "How to Document?". >>> >>> On Mon, Oct 30, 2017 at 12:27 PM, Denis Magda <dma...@apache.org> wrote: >>> >>>> Igniters, >>>> >>>> Our project is broadly documented so it’s becoming harder and harder to >>>> keep the docs consistent and updated. During several last months we >> tried >>>> the new approach with some of community members and took it down on >> paper: >>>> https://cwiki.apache.org/confluence/display/IGNITE/Documentation >>>> >>>> Please read it through and keep to it going forward or propose your >>>> changes if you’re like. Presently this approach proved to be effective. >>>> >>>> — >>>> Denis >> >>
