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 <rmetz...@apache.org> wrote: > 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 <konstan...@ververica.com > > > wrote: > > > 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 with clear separation of concerns > > > > * Expand and restructure existing Concepts section > > > > * Align Application Development with current state and Flink roadmap > > > > * Improve documentation on Deployment & Operations > > > > ** *Improve getting-started experience > > > > * Use of a common terminology > > > > * Add a documentation style guide > > > > > > It is quite an ambitions endeavor, but we can tackle these changes in > > multiple phases and we will benefit from it even if the whole FLIP takes > > some time to be implemented. > > > > The whole description of the FLIP (proposed documentation structure & > > sections, changes, implementation plan) is available on Google Docs [1] > for > > now for simplicity. I will move it to Confluence once we have reached > > consensus. > > > > Please let us know what you think and I am looking forward to your > > feedback, opinions and comments on the proposal. > > > > Cheers, > > > > Konstantin > > > > [1] > > > > > https://docs.google.com/document/d/1pPM4vTWUUiJb73pd8OqHA1EWVl9cv6kXoCB5F7_J6gM/edit?usp=sharing > > > > > > -- > > > > Konstantin Knauf | Solutions Architect > > > > +49 160 91394525 > > > > > > Planned Absences: 20. - 21.06.2019 > > > > > > <https://www.ververica.com/> > > > > Follow us @VervericaData > > > > -- > > > > Join Flink Forward <https://flink-forward.org/> - The Apache Flink > > Conference > > > > Stream Processing | Event Driven | Real Time > > > > -- > > > > Data Artisans GmbH | Invalidenstrasse 115, 10115 Berlin, Germany > > > > -- > > Data Artisans GmbH > > Registered at Amtsgericht Charlottenburg: HRB 158244 B > > Managing Directors: Dr. Kostas Tzoumas, Dr. Stephan Ewen > > >