Hi, Thanks for stepping up Konstantin! Yes, I'd be up to serve as a mentor as well.
I assume the set up is similar as for Google Summer of Code (GSoC). For GSoC the whole Apache Software Foundation applied as an organization (not every individual project). Hence, there should be only two organizers for the ASF and a bunch of mentors for each project. We would need to coordinate with the other projects that participate. @Aizhamal is that correct? Also, for GSoC, Google grants a certain number of participants per organization. IIRC these spots were then distributed among the interested projects. So even if the ASF is accepted as an organization, it would not be guaranteed that the Flink project would get a technical writer (+ we also need to find somebody who is interested in working on Flink's docs). Best, Fabian Am Mi., 10. Apr. 2019 um 10:46 Uhr schrieb Konstantin Knauf < konstan...@ververica.com>: > Hi all, > > I am happy to start our application process and help as a mentor. For our > application, we need a second organization administrator (assuming I am the > first). The tasks as an administrator are listed in [1] (basically only > guiding the organization through the SoD process). Is anyone interested? > > We need at least two mentors. The responsibilities as a mentor are laid out > in [2]. I understood, David would be up to it. @Fabian, @Stephan: Should we > put you down as mentors as well? I guess it can not hurt to have more than > two... > > Is anyone else interested to mentor? Please reach out soon, so that we can > start working on the list of project ideas. > > Best, > > Konstantin > > [1] https://developers.google.com/season-of-docs/docs/admin-guide > [2] https://developers.google.com/season-of-docs/docs/mentor-guide > > > On Wed, Apr 10, 2019 at 9:29 AM Stephan Ewen <se...@apache.org> wrote: > > > Hi all! > > > > This is a really great initiative, I think the Flink docs could benefit > > big time from this. > > Aside from some nice tutorials, I think that especially the docs about > > concepts, architecture, and deployment need a lot of work, so users > > understand how powerful Flink really is. > > > > I quickly connected offline with Konstantin and David who contributed to > > docs in the past and work a lot with Flink users as part of training > > (giving them a good insight into where docs could be improved) - both > > seemed excited about this opportunity. > > > > I would be happy to help as well, probably not have time to be a good > > mentor, but to help out with ideas what to improve and to brief the > writers > > on Flink concepts. > > > > Best, > > Stephan > > > > > > On Tue, Apr 9, 2019 at 6:49 PM Fabian Hueske <fhue...@gmail.com> wrote: > > > >> Hi Aizhamal, hi everyone, > >> > >> Thanks for sharing this opportunity with our community! > >> I can think of a few projects that could be done as part of GSoD. > >> > >> 1) Flink's user documentation is (IMO) fairly extensive and mostly > >> complete, but its structure could be improved in some areas (event-time, > >> state management). > >> 2) We are lacking some good tutorials to get started with Flink > >> (Docker-based setup, SQL + SQL Client, Table API, ...) > >> 3) More documentation on Flink's internals (mostly relevant for people > >> contributing to Flink) would be great to have. > >> > >> Looking at the timeline for GSoD, I see that the documentation work > would > >> start in September. > >> Although there is a good chance that some of these issues will still be > >> present in five months from now, I don't think we would hold them back > in > >> case somebody wants to start an effort to work on them. > >> There have been some efforts and also a PR [1] to improve some aspects > of > >> the documentation. Unfortunately, the linked PR was not merged yet due > to > >> lack of committer involvement. > >> > >> Obviously, we would need at least two mentors (I think at least one > should > >> be a committer) who dedicate a good amount of their time for the GSoD > >> project. > >> Is there somebody in the community, who would be interested in being a > >> mentor for GSoD? > >> > >> Best, > >> Fabian > >> > >> [1] https://github.com/apache/flink/pull/6481 > >> > >> Am Sa., 6. Apr. 2019 um 00:44 Uhr schrieb Aizhamal Nurmamat kyzy > >> <aizha...@google.com.invalid>: > >> > >> > Hello everyone, > >> > > >> > TL;DR If you need some improvements for Flink documentation, apply to > >> > Season of Docs before April 23rd. > >> > > >> > Background: > >> > > >> > Season of Docs is like Google Summer of Code, but for documentation. > >> > Projects write ideas on how they would like to improve their > >> documentation, > >> > then if they are accepted to the program, they will get a professional > >> tech > >> > writer to work on the project’s documentation for 3 months. Technical > >> > writer’s get stipend from Google. > >> > > >> > If you think that Apache Flink could benefit from it, please submit > the > >> > application before April 23rd. > >> > > >> > The program requires two administrators, to manage the organization's > >> > participation in SoD, and at least two mentors to onboard tech writers > >> to > >> > the project, and work with them closely during 3 months period [2]. To > >> be a > >> > mentor in this program, you don't have to be a technical writer, but > you > >> > must know Flink and the open source well to onboard/introduce tech > >> writers > >> > to the project, and be able to support them during the whole process. > >> > > >> > I am an administrator for 2 Apache projects, and will be more than > >> happy to > >> > share my knowledge on this, if you, as an organization decide to > apply. > >> > > >> > I think it will be great if Flink participates in it too! > >> > > >> > Thanks, > >> > Aizhamal > >> > > >> > [1] https://developers.google.com/season-of-docs/ > >> > [2] https://developers.google.com/season-of-docs/docs/timeline > >> > > >> > > > > -- > > Konstantin Knauf | Solutions Architect > > +49 160 91394525 > > <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 >
