Awesome. Great job. On Mon, 11 May 2020 at 7:22 PM, Seth Wiesman <sjwies...@gmail.com> wrote:
> Thank you for putting this together Marta! > > On Mon, May 11, 2020 at 8:35 AM Fabian Hueske <fhue...@gmail.com> wrote: > > > Thanks Marta and congratulations! > > > > Am Mo., 11. Mai 2020 um 14:55 Uhr schrieb Robert Metzger < > > rmetz...@apache.org>: > > > > > Awesome :) > > > Thanks a lot for driving this Marta! > > > > > > Nice to see Flink (by virtue of having Apache as part of the name) so > > high > > > on the list, with other good open source projects :) > > > > > > > > > On Mon, May 11, 2020 at 2:18 PM Marta Paes Moreira < > ma...@ververica.com> > > > wrote: > > > > > > > I'm happy to announce that we were *accepted* into this year's Google > > > > Season of Docs! > > > > > > > > The list of projects was published today [1]. The next step is for > > > > technical writers to reach out (May 11th-June 8th) and apply (June > > > 9th-July > > > > 9th). > > > > > > > > Thanks again to everyone involved! I'm really looking forward to > > kicking > > > > off the project in September. > > > > > > > > [1] https://developers.google.com/season-of-docs/docs/participants/ > > > > > > > > Marta > > > > > > > > On Thu, Apr 30, 2020 at 5:14 PM Marta Paes Moreira < > > ma...@ververica.com> > > > > wrote: > > > > > > > > > The application to Season of Docs 2020 is close to being finalized. > > > I've > > > > > created a PR with the application announcement for the Flink blog > [1] > > > (as > > > > > required by Google OSS). > > > > > > > > > > Thanks a lot to everyone who pitched in — and special thanks to > > > Aljoscha > > > > > and Seth for volunteering as mentors! > > > > > > > > > > I'll send an update to this thread once the results are out (May > > 11th). > > > > > > > > > > [1] https://github.com/apache/flink-web/pull/332 > > > > > > > > > > On Mon, Apr 27, 2020 at 9:28 PM Seth Wiesman <sjwies...@gmail.com> > > > > wrote: > > > > > > > > > >> Hi Marta, > > > > >> > > > > >> I think this is a great idea, I'd be happy to help mentor a table > > > > >> documentation project. > > > > >> > > > > >> Seth > > > > >> > > > > >> On Thu, Apr 23, 2020 at 8:38 AM Marta Paes Moreira < > > > ma...@ververica.com > > > > > > > > > >> wrote: > > > > >> > > > > >> > Thanks for the feedback! > > > > >> > > > > > >> > So far, the projects on the table are: > > > > >> > > > > > >> > 1. Improving the Table API/SQL documentation. > > > > >> > 2. Improving the documentation about Deployments. > > > > >> > 3. Restructuring and standardizing the documentation about > > > > >> Connectors. > > > > >> > 4. Finishing the Chinese translation. > > > > >> > > > > > >> > I think 2. would require a lot of technical knowledge about > Flink, > > > > which > > > > >> > might not be a good fit for GSoD (as discussed last year). > > > > >> > > > > > >> > As for mentors, we have: > > > > >> > > > > > >> > - Aljoscha (Table API/SQL) > > > > >> > - Till (Deployments) > > > > >> > - Stephan also said he'd be happy to participate as a mentor > if > > > > >> needed. > > > > >> > > > > > >> > For the translation project, I'm pulling in the people involved > in > > > > last > > > > >> > year's thread (Jark and Jincheng), as we would need two > > > > chinese-speaking > > > > >> > mentors. > > > > >> > > > > > >> > I'll follow up with a draft proposal early next week, once we > > reach > > > a > > > > >> > consensus and have enough mentors (2 per project). Thanks again! > > > > >> > > > > > >> > Marta > > > > >> > > > > > >> > > > > > >> > On Fri, Apr 17, 2020 at 2:53 PM Till Rohrmann < > > trohrm...@apache.org > > > > > > > > >> > wrote: > > > > >> > > > > > >> > > Thanks for driving this effort Marta. > > > > >> > > > > > > >> > > I'd be up for mentoring improvements for the deployment > section > > as > > > > >> > > described in FLIP-42. > > > > >> > > > > > > >> > > Cheers, > > > > >> > > Till > > > > >> > > > > > > >> > > On Fri, Apr 17, 2020 at 11:20 AM Aljoscha Krettek < > > > > >> aljos...@apache.org> > > > > >> > > wrote: > > > > >> > > > > > > >> > > > Hi, > > > > >> > > > > > > > >> > > > first, excellent that you're driving this, Marta! > > > > >> > > > > > > > >> > > > By now I have made quite some progress on the FLIP-42 > > > > restructuring > > > > >> so > > > > >> > > > that is not a good effort for someone to join now. Plus > there > > is > > > > >> also > > > > >> > > > [1], which is about incorporating the existing Flink > Training > > > > >> material > > > > >> > > > into the concepts section of the Flink doc. > > > > >> > > > > > > > >> > > > What I think would be very good is working on the Table > > API/SQL > > > > >> > > > documentation [2]. We don't necessarily have to take the > FLIP > > > as a > > > > >> > basis > > > > >> > > > but we can, or we can start from a blank slate. I think the > > > > current > > > > >> > > > structure as well as the content is sub-optimal (not good, > > > > really). > > > > >> It > > > > >> > > > would be ideal to have someone get to now the system and > then > > > > write > > > > >> > > > documentation for that part of Flink that has both good > > > structure > > > > >> and > > > > >> > > > content and nicely guides new users. > > > > >> > > > > > > > >> > > > I would be very happy to mentor that effort. > > > > >> > > > > > > > >> > > > Best, > > > > >> > > > Aljoscha > > > > >> > > > > > > > >> > > > [1] > > > > >> > > > > > > > >> > > > > > > > >> > > > > > > >> > > > > > >> > > > > > > > > > > https://lists.apache.org/thread.html/rea9cbfffd9a1c0ca6f78f7e8c8497d81f32ed4a7b9e7a05d59f3b2e9%40%3Cdev.flink.apache.org%3E > > > > >> > > > > > > > >> > > > [2] > > > > >> > > > > > > > >> > > > > > > >> > > > > > >> > > > > > > > > > > https://cwiki.apache.org/confluence/pages/viewpage.action?pageId=127405685 > > > > >> > > > > > > > >> > > > On 17.04.20 09:21, Robert Metzger wrote: > > > > >> > > > > 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 > > > > >> > > > >> > > > > >> > > > > > > > > >> > > > > > > > >> > > > > > > > >> > > > > > > >> > > > > > >> > > > > > > > > > > > > > > >
