Hi Marta, Thanks for kicking off the discussion. Aljoscha has recently revived the implementation of the FLIP-42 and has already moved things around quite a bit. [1]
There are a lot of areas that can be improved of course, but a lot of them require very deep knowledge about the system (e.g. the "Deployment" or "Concepts" section). One area that I could imagine working well in such a format is to work on the "Connectors" section. Aljoscha has already moved this to the top-level, but it besides that it has not been touched yet in the course of FLIP-42. The documentation project could be around restructuring, standardization and generally improving the documentation of our connectors for both Datastream as well as Table API/SQL. Cheers, Konstantin [1] https://ci.apache.org/projects/flink/flink-docs-master/ On Wed, Apr 15, 2020 at 12:11 PM Marta Paes Moreira <ma...@ververica.com> wrote: > Hi, Everyone. > > Google is running its Season of Docs [1] program again this year. The goal > of the program is to pair open source organizations/projects with > professional technical writers to improve their documentation. > > The Flink community submitted an application in 2019 (led by Konstantin) > [2,3], but was unfortunately not accepted into the program. This year, I'm > volunteering to write and submit the proposal in the upcoming weeks. To > achieve this, there are a few things that need to be sorted out in advance: > > - > *Mentors *Each proposed project idea requires at least two volunteers to > mentor technical writers through the process. *Who would like to > participate as a mentor*? You can read about the responsibilities here > [4]. > > > - > *Project Ideas *We can submit as many project ideas as we'd like, but it's > unlikely that more than 2 are accepted. *What would you consider a > priority for documentation improvement*? In my opinion, reorganizing the > documentation to make it easier to navigate and more accessible to > newcomers would be a top priority. You can check FLIP-42/FLINK-12639 [5] > for improvements that are already under consideration and [6] for last > year's mailing list discussion. > > > - *Alternative Organization Administrator* > I volunteer as an administrator, but Google requires two. *Who would > like to join me as an application administrator*? > > The deadline is *May 4th *and the accepted projects would kick-off the work > with technical writers on *September 14th*. Let me know if you have any > questions! > > Thanks, > > Marta > > [1] https://developers.google.com/season-of-docs > [2] > > https://lists.apache.org/thread.html/3c789b6187da23ad158df59bbc598543b652e3cfc1010a14e294e16a@%3Cdev.flink.apache.org%3E > [3] > > https://docs.google.com/document/d/1Up53jNsLztApn-mP76AB6xWUVGt3nwS9p6xQTiceKXo/edit?usp=sharing > [4] https://developers.google.com/season-of-docs/docs/mentor-guide > [5] https://issues.apache.org/jira/browse/FLINK-12639 > [6] > > https://lists.apache.org/thread.html/3c789b6187da23ad158df59bbc598543b652e3cfc1010a14e294e16a@%3Cdev.flink.apache.org%3E > -- Konstantin Knauf