Thanks a lot for volunteering to drive an application for the Flink project!
Last year, we discussed finishing the chinese translation as a potential project. I believe there's still a need for this. Since the work on the project starts pretty far in the future (September), the translation project is a good fit as well (there's currently no major effort on the translation, rather a constant flow of PRs, but I don't think that is enough to finish the translation). On Fri, Apr 17, 2020 at 9:15 AM Konstantin Knauf <kna...@apache.org> wrote: > 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 >
