Re: [DISCUSS] FLIP to Restructure, Update & Rework Apache Flink's Documentation

2019-05-28 Thread Konstantin Knauf
Hi everyone, thank you all for your comments. I agree with Fabian, there are a lot of independent contributions subsumed in this FLIP (like Concepts or Getting Started), which indepdently will already make a big difference for new users. It looks like overall, the FLIP is accepted. Therefore, I h

Re: [DISCUSS] FLIP to Restructure, Update & Rework Apache Flink's Documentation

2019-05-27 Thread Fabian Hueske
Hi All, I obviously support this proposal, but I'd like to emphasize two points. * I think we can significantly improve the getting-started experience with better (and up-to-date) tutorials. * A better structure and separation of concepts and API will be very helpful. I noticed this when I was re

Re: [DISCUSS] FLIP to Restructure, Update & Rework Apache Flink's Documentation

2019-05-22 Thread Jark Wu
Hi Konstantin, Thanks a lot for preparing this FLIP. It's great to see we can continue the work on improving documentation. I have read it and +1 from my side. And I will coordination Chinese translation work and this FLIP. Regards, Jark On Wed, 22 May 2019 at 16:02, Robert Metzger wrote: >

Re: [DISCUSS] FLIP to Restructure, Update & Rework Apache Flink's Documentation

2019-05-22 Thread Robert Metzger
Thanks a lot for working on this FLIP! I just read it, and it seems well written and well thought out. +1 from my side to put it into Confluence and start working on the docs :) On Mon, May 20, 2019 at 7:23 PM Konstantin Knauf wrote: > Hi all, > > following our unsuccessful application to Sea

[DISCUSS] FLIP to Restructure, Update & Rework Apache Flink's Documentation

2019-05-20 Thread Konstantin Knauf
Hi all, following our unsuccessful application to Season of Docs Fabian, Seth, Stephan and myself have drafted a FLIP for reworking our documentation and implementing some (or most) of the changes, we would have liked to tackle in SoD. The overarching goals of the FLIP are: * Top-level structure