Mailing-List: contact dev-help@flink.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@flink.apache.org
MIME-Version: 1.0
In-Reply-To: <CAHpOOhF_k_ieK8UUPe-hasQzqNJeTympR_LVS0=8sVWfaaB2mw@mail.gmail.com>
References: <CAGr9p8Dh_WrFKjijyuRoH_qbgD=psJAcDRQcAhW9j30UNbNZFg@mail.gmail.com>
 <CAAjCYUWTPdeRtVC0nBJcHKo-E2=101__Oy_O6obH=xRf=Ej24A@mail.gmail.com>
 <CAC27z=NuOV=t6eEthntZVCeRu9JwW4OfWN47DEMwNoZ3gMjb=A@mail.gmail.com>
 <CAKiyyaHzNUAtXQSdpxMi7-Z--B4kZiDU2dOZotKq6c1Au=sxYQ@mail.gmail.com>
 <2522A0AF-0B96-4446-92EC-D9A088EF6B10@data-artisans.com> <CAAdrtT0BLVfahJegq7y1R=xq-aO0LEDDngD8Kb8zM0xWY6H-Pw@mail.gmail.com>
 <CAGr9p8BiY_2z3RZwqg_inTEjhJbM3OKGFzvAyhvwFnQNKTt-Ew@mail.gmail.com> <CAHpOOhF_k_ieK8UUPe-hasQzqNJeTympR_LVS0=8sVWfaaB2mw@mail.gmail.com>
From: Fabian Hueske <fhueske@gmail.com>
Date: Fri, 19 May 2017 01:06:33 +0200
Message-ID: <CAAdrtT27d7yoArqv=TwdTvdVXPaY2mu_E4L28m8OLt19c7OtkQ@mail.gmail.com>
Subject: Re: [DISCUSS] Reorganize Table API / SQL documentation
To: "dev@flink.apache.org" <dev@flink.apache.org>
Content-Type: multipart/alternative; boundary="001a1142933e8e42aa054fd47674"
archived-at: Thu, 18 May 2017 23:07:09 -0000

--001a1142933e8e42aa054fd47674
Content-Type: text/plain; charset="UTF-8"

Hi everybody,

I came up with a proposal for the structure of the Table API / SQL
documentation:

https://docs.google.com/document/d/1ENY8tcPadZjoZ4AQ_lRRwWiVpScDkm_4rgxIGWGT5E0/edit?usp=sharing

Feedback and comments are very welcome.
Once we agree on a structure, we can create skeletons and distribute the
work.

Cheers,
Fabian

2017-05-18 21:01 GMT+02:00 Haohui Mai <ricetons@gmail.com>:

> +1
>
> The Table / SQL component has made significant progress in the last few
> months (kudos to all contributors).
>
> It is a good time to have a documentation to reflect all the changes in the
> Table / SQL side.
>
>
>
> On Thu, May 18, 2017 at 8:12 AM Robert Metzger <rmetzger@apache.org>
> wrote:
>
> > Thank you Fabian for working on the proposal.
> >
> > On Thu, May 18, 2017 at 3:51 PM, Fabian Hueske <fhueske@gmail.com>
> wrote:
> >
> > > Thanks for starting this discussion Robert.
> > >
> > > I think with the next release the Table API / SQL should be moved up in
> > the
> > > Application Development menu.
> > > I also though about restructuring the docs, but it won't be trivial to
> do
> > > this, IMO because there are many orthogonal aspects:
> > > - Stream/Batch
> > > - Table/SQL
> > > - Scala/Java
> > >
> > > and sometimes also common concepts.
> > > At the moment there are also many new features missing like OVER
> windows,
> > > UDAGGs, retraction, StreamTableSinks, time indicator attributes, filter
> > > pushdown, ...
> > >
> > > I will try to sketch a new structure in a Google Doc in the next days
> and
> > > share it in this thread.
> > >
> > > Cheers, Fabian
> > >
> > > 2017-05-18 14:03 GMT+02:00 Kostas Kloudas <k.kloudas@data-artisans.com
> >:
> > >
> > > > A big +1 as well.
> > > >
> > > > > On May 18, 2017, at 1:55 PM, Ufuk Celebi <uce@apache.org> wrote:
> > > > >
> > > > > On Thu, May 18, 2017 at 1:52 PM, Till Rohrmann <
> trohrmann@apache.org
> > >
> > > > wrote:
> > > > >> I think we have a history of creating too long monolithic
> > > documentation
> > > > >> pages which are hard to digest. So a big +1 for splitting the
> Table
> > > > API/SQL
> > > > >> documentation up into more easily digestible pieces.
> > > > >
> > > > > +1
> > > > >
> > > > > Thanks for bringing it up
> > > >
> > > >
> > >
> >
>

--001a1142933e8e42aa054fd47674--