Hello! I'm not really sold on the github version yet, I would like to see a prototype of such documentation before deciding, so for me it'w 0
Pavel, we don't have enough discipline to make sure that all documentation is ready at the time of release, and we may need to add notices here and there after a release is already out. This means, separate git repository, or at least separate git tag on that repository, is needed. Regards, -- Ilya Kasnacheev вт, 23 июн. 2020 г. в 12:15, Pavel Tupitsyn <[email protected]>: > +1 > > > stored in a github repository > Do you mean a separate repository here? > I think we should use the main Ignite repo for documentation. > > > > On Tue, Jun 23, 2020 at 10:21 AM Nikita Amelchev <[email protected]> > wrote: > > > +1 > > For now it's unclear how to add new pages to the site. I hope it'll be > > a clear process. > > > > вт, 23 июн. 2020 г. в 10:06, Alexey Zinoviev <[email protected]>: > > > > > > I'd like this approach, it's easier for contributors to suggest edits. > > > +1 > > > > > > вт, 23 июн. 2020 г. в 10:03, Nikolay Izhikov <[email protected]>: > > > > > > > +1. > > > > > > > > > 23 июня 2020 г., в 10:02, Artem Budnikov < > > [email protected]> > > > > написал(а): > > > > > > > > > > Hello Igniters, > > > > > > > > > > I'd like to return to the discussion about migrating the Ignite > > > > documentation from readme.io to github. The idea emerged long time > ago > > > > [1] but hasn't been implemented. I think now is the time to make it > > happen. > > > > > > > > > > Here are the technical details of the proposed solution: > > > > > > > > > > * docs are written in asciidoc format and stored in a github > > repository > > > > > * jekyll is used to generate HTML pages out of the adoc files > > > > > * HTML pages are published on ignite.apache.org in the > documentation > > > > > section > > > > > > > > > > This approach is very flexible and allows us to implement any > feature > > > > that we need (as opposed to readme.io, which is very limited). > > > > > > > > > > Also, as part of this plan, it makes sense to unite the > documentation > > > > for different platforms (java, .NET, c++). > > > > > > > > > > I'm interested in what you have to say about this. Please share > your > > > > thoughts. > > > > > > > > > > -Artem > > > > > > > > > > [1]: > > > > > > > http://apache-ignite-developers.2346864.n4.nabble.com/Move-documentation-from-readme-io-to-GitHub-pages-td16409.html > > > > > > > > > > > > > > > > > > > > > -- > > Best wishes, > > Amelchev Nikita > > >
