Igniters, I’m glad to share that the new SQL doc is ready for proof read: https://apacheignite-sql.readme.io/docs
Main sections: - Overview - SQL capabilities outline and getting started guide. - SQL Reference - SQL itself with all the commands and operations. - Architecture - insights on how SQL engine works and some of its features. - JDBC - ODBC - Tools and Analytics - tools to work with Ignite as with SQL database. - Java Dev Guide - Java specific features - .NET Dev Guide - .NET specific features - C++ Dev Guide - C++ specific features Note, that all the SQL related pages will be hidden (consider removed) on Java, .NET and C++ readme.io sites in 2.3. All the SQL related capabilities have to be documented on this new specific doc. Here is we’re tracking minor documentation tasks to close before the release: https://issues.apache.org/jira/browse/IGNITE-6685 Many thanks to Sergey Puchnin for the help with SQL reference documentation! — Denis > On Sep 14, 2017, at 5:00 AM, Serge Puchnin <sergey.puch...@gmail.com> wrote: > > Denis, > Thanks a lot for the link. > It's very helpful to split "function part" to more specific like 'string', > 'numeric', etc. > > the main reason to separate "Java Developer" as an independent part because > it's about a mix between Java and SQL code. > It's about classes, methods, annotation, GC, etc. > It doesn't fully belong to the SQL specification but IMHO should be in SQL > category. > > BR, > Serge > > On Wed, 13 Sep 2017 at 22:39, Denis Magda <dma...@apache.org> wrote: > >> Serge, >> >> I like the proposed format. It reminds me the one chosen by MemSQL which >> is crystal clear: >> https://docs.memsql.com/sql-reference/v5.8/sql-reference-overview/ >> >> Not 100% sure about “Java Developer Guides” section. Let me contemplate a >> bit and propose other solutions. >> >> — >> Denis >> >> On Sep 13, 2017, at 3:41 AM, Serge Puchnin <sergey.puch...@gmail.com> >> wrote: >> >> I have done some reorganizing for the SQL documentation. >> Thanks a lot for the review and proof read. >> >> >> >> On Wed, 13 Sep 2017 at 01:22, Dmitriy Setrakyan <dsetrak...@apache.org> >> wrote: >> >>> Thanks Sergey, I think we should add SQL Syntax section on the left. Also, >>> please let us know when we can proof read it. I would like to fix some >>> phrasing on the page. >>> >>> On Tue, Sep 12, 2017 at 8:26 AM, Serge Puchnin <sergey.puch...@gmail.com> >>> wrote: >>> >>>> I've added a page for SQL language, create index statement and Upper >>>> function as an example for the new format: >>>> >>>> https://apacheignite-sql.readme.io/v2.1/docs/create-index >>>> >>>> >>>> >>>> For me, it'd be OK to add a separate page for each SQL statement. >>>> >>>> >>>> BR, >>>> >>>> Serge >>>> >>>> On Sat, 9 Sep 2017 at 02:19, Denis Magda <dma...@apache.org> wrote: >>>> >>>>> Please check you inbox. >>>>> >>>>> — >>>>> Denis >>>>> >>>>>> On Sep 8, 2017, at 3:38 PM, Dmitriy Setrakyan < >>> dsetrak...@apache.org> >>>>> wrote: >>>>>> >>>>>> Denis, >>>>>> >>>>>> Can you please add me as an admin to that site? >>>>>> >>>>>> D. >>>>>> >>>>>> On Fri, Sep 8, 2017 at 3:23 PM, Denis Magda <dma...@apache.org> >>> wrote: >>>>>> >>>>>>> Igniter (especially those who are willing to work on the new SQL >>> doc), >>>>>>> >>>>>>> The doc for SQL capabilities has been set up. Copy pasted all the >>> SQL >>>>>>> materials we have there: >>>>>>> https://apacheignite-sql.readme.io/docs <https://apacheignite-sql. >>>>>>> readme.io/docs> >>>>>>> >>>>>>> Sergey P., feel free to start reworking the doc according to the >>> new >>>>>>> proposed format. Don’t hesitate removing outdating or misleading >>>>> content. >>>>>>> If you’re uncertain about something just send us a message here. >>>>>>> >>>>>>> Presently the doc is not indexed by searching engines. Let’s >>> finish it >>>>>>> first and announce afterwards. >>>>>>> >>>>>>> — >>>>>>> Denis >>>>>>> >>>>>>>> On Aug 30, 2017, at 5:43 PM, Dmitriy Setrakyan < >>>> dsetrak...@apache.org> >>>>>>> wrote: >>>>>>>> >>>>>>>> On Wed, Aug 30, 2017 at 10:04 PM, Denis Magda <dma...@apache.org> >>>>> wrote: >>>>>>>> >>>>>>>>> Serge, >>>>>>>>> >>>>>>>>> Undoubtedly, I like this format. I’ve created a new documentation >>>>> domain >>>>>>>>> for all our SQL capabilities: >>>>>>>>> https://apacheignite-sql.readme.io/docs < >>> https://apacheignite-sql. >>>>>>>>> readme.io/docs> >>>>>>>>> >>>>>>>>> Once I get an open source license for it we can start moving the >>>>>>> existing >>>>>>>>> docs and create the new there. >>>>>>>>> >>>>>>>> >>>>>>>> Sounds good. We should make sure that we do not "move" the >>>>> documentation, >>>>>>>> we should "copy" it. Otherwise we will get 404 errors in google. >>>>>>>> >>>>>>>> >>>>>>>>> >>>>>>>>> — >>>>>>>>> Denis >>>>>>>>> >>>>>>>>>> On Aug 30, 2017, at 4:38 AM, Serge Puchnin n < >>>>> sergey.puch...@gmail.com >>>>>>>> >>>>>>>>> wrote: >>>>>>>>>> >>>>>>>>>> Sorry for inconvenience! >>>>>>>>>> there is a link for a sample: >>>>>>>>>> https://drive.google.com/open?id=0B-s4Ivq- >>>>>>> lrPobzZ4c2Y1X1ZLcWhGenE4TllVM3 >>>>>>>>> VlODhtT2Iw >>>>>>>>>> >>>>>>>>>> Serge >>>>>>>>>> >>>>>>>>>>> On 29 Aug 2017, at 19:30, Denis Magda <dma...@apache.org> >>> wrote: >>>>>>>>>>> >>>>>>>>>>> Serge, >>>>>>>>>>> >>>>>>>>>>> The attachment is missing. Try to share it via google drive or >>>> other >>>>>>>>> storage. >>>>>>>>>>> >>>>>>>>>>> — >>>>>>>>>>> Denis >>>>>>>>>>> >>>>>>>>>>>> On Aug 29, 2017, at 2:38 AM, Serge Puchnin < >>>>> sergey.puch...@gmail.com >>>>>>>> >>>>>>>>> wrote: >>>>>>>>>>>> >>>>>>>>>>>> Hi ! >>>>>>>>>>>> >>>>>>>>>>>> As I can see, there is some room for documentation >>> improvement. >>>>>>>>>>>> As a sample of documentation, I've prepared a description of >>>>> "CREATE >>>>>>>>> INDEX" statement. >>>>>>>>>>>> >>>>>>>>>>>> What’s your opinion? >>>>>>>>>>>> What can be improved? >>>>>>>>>>>> What should be added? >>>>>>>>>>>> >>>>>>>>>>>> Thanks a lot! >>>>>>>>>>>> >>>>>>>>>>>> --- >>>>>>>>>>>> Serge >>>>>>>>>>> >>>>>>>>> >>>>>>>>> >>>>>>> >>>>>>> >>>>> >>>>> >>>> >>> >> >>
