[DISCUSS] Apache Flink at Season of Docs

[Konstantin Knauf-3]

Hi all,

I read through the SoD documentation again, and now I think, it would
actually make sense to split (1) up into multiple project ideas. Let me
summarize the overall process:

1. We create & publish a list of project ideas, e.g. in a blog post. (This
can be any number of ideas.)
2. Potential technical writers look at our list of ideas and sent a
proposal for a particular project to Google. During that time they can
reach out to us for clarification.
3. Google forwards all proposals for our project ideas to us and we sent
back a prioritized list of proposals, which we would like to accept.
4. Of all these proposals, Google accepts 50 proposals for SoD 2019. Per
organization Google will only accept a maximum of two proposals.

@Aizhamal Nurmamat kyzy <[hidden email]> Please correct me!

For me this means we should splits this up in a way, that each project is
a) still relevant in September b) makes sense as a 3 month project. Based
on the ideas we have right now these could for example be:

(I) Rework/Extract/Improve the documentation of stream processing concepts
(II) Improve & extend Apache Flink's documentation for deployment,
operations (incl. configuration)
(III) Add documentation for Flink internals
(IV) Rework Table API / SQL documentation

We would then get proposals potentially for all of these topics and could
decide which of these proposals, we would sent back to Google. My feeling
is that a technical writer could easily spent three months on any of these
projects. What do others think? Any other project ideas?

Cheers,

Konstantin




On Fri, Apr 12, 2019 at 1:47 PM Jark Wu <[hidden email]> wrote:

> Hi all,
>
> I'm fine with only preparing the first proposal. I think it's reasonable
> because the first proposal is more attractive
> and maybe there is not enough Chinese writer. We can focus on one project
> to come up with a concrete and
> attractive project plan.
>
> One possible subproject could be rework Table SQL docs.
> (1). Improve concepts in Table SQL.
> (2). A more detailed introduction of built-in functions, currently we only
> have a simple explanation for each function.
>       We should add more descriptions, especially more concrete examples,
> and maybe some notes. We can take
>       MySQL doc [1] as a reference.
> (3). As Flink SQL is evolving rapidly and features from Blink is being
> merged,  for example, SQL DDL, Hive integration,
>       Python Table API, Interactive Programing, SQL optimization and
> tuning, etc... We can redesign the doc structure of
>       Table SQL in a higher vision.
>
> Cheers,
> Jark
>
> [1]:
> https://dev.mysql.com/doc/refman/5.7/en/string-functions.html#function_bin
>
>
>
> On Fri, 12 Apr 2019 at 18:19, jincheng sun <[hidden email]>
> wrote:
>
> > I am honored to have the opportunity to do a second organization
> > administrator‘s works!
> >
> > It seems that one project and multiple projects have their own
> advantages.
> >
> > My understanding is that even if we only have one project, we also can
> have
> > multiple mentors and recruit enough writers.
> >
> > Fabian Hueske <[hidden email]> 于2019年4月12日周五 下午5:57写道：
> >
> > > Yes, I think we would get at most one project accepted.
> > > Having all options in a rather generic proposal gives us the most
> > > flexibility to decide what to work on once the proposal is accepted.
> > > On the other hand, a more concrete proposal might look more attractive
> > for
> > > candidates.
> > > I'm fine either way, but my gut feeling is that a well scoped proposal
> > > gives better changes of finding a writer (which might be the biggest
> > > challenge).
> > >
> > > Am Fr., 12. Apr. 2019 um 11:39 Uhr schrieb Stephan Ewen <
> > [hidden email]
> > > >:
> > >
> > > > I would suggest to make one proposal and have the subsections only in
> > the
> > > > project plan.
> > > > My understanding is that we need to indicate priorities between
> > proposals
> > > > and might get only one, so it would be good to not subdivide.
> > > >
> > > > On Fri, Apr 12, 2019 at 9:58 AM Fabian Hueske <[hidden email]>
> > wrote:
> > > >
> > > > > Hi everyone,
> > > > >
> > > > > I think we can split the first project that Stephan proposed into
> > > smaller
> > > > > ones:
> > > > >
> > > > > > (1) Create or rework setup / tutorials / concepts docs
> > > > > > (2) Complete (or advance) the Chinese translation
> > > > >
> > > > > 1.1 Improving (extracting) the documentation of stream processing
> > > > concepts:
> > > > > Event-time, Timers, State, State Backends, Checkpointing,
> Savepoints
> > > > > Right now, the relevant information is scattered across several
> pages
> > > and
> > > > > mixed with the implementation / APIs / configuration options.
> > > > >
> > > > > 1.2 Improving & extending the documentation of deployments
> > > > >
> > > > > 1.3 Adding documentation in the internals: Distributed
> architecture,
> > > > > recovery, operators, job translation, execution, etc.
> > > > > This documentation would be targeted to Flink developers.
> > > > >
> > > > > I thought again about the idea of improving the tutorials, and I'm
> no
> > > > > longer sure if this would fit SoD well.
> > > > > The reason is that creating good tutorials requires a good portion
> of
> > > > > coding / configuration (creating Docker images, example programs,
> > > etc.).
> > > > > Also I'd like to start improving the situation of tutorials earlier
> > > than
> > > > > September.
> > > > >
> > > > > What do others think?
> > > > >
> > > > > Cheers, Fabian
> > > > >
> > > > >
> > > > > Am Fr., 12. Apr. 2019 um 04:29 Uhr schrieb Jark Wu <
> [hidden email]
> > >:
> > > > >
> > > > > > Hi Konstantin, Ken,
> > > > > >
> > > > > > I agree that Chinese documentation is mainly a translation.
> > > > > >
> > > > > > >  Does anyone from the Blink team have input on whether there is
> > > > > existing,
> > > > > > original Chinese documentation which should be translated to
> > English?
> > > > > >
> > > > > > There is a public Blink documentation [1] which is English.
> > > > > > We have a Blink Chinese documentation in internal, but I think we
> > > need
> > > > to
> > > > > > rewrite it in English and restructure it when contributing Blink
> to
> > > > > Flink.
> > > > > >
> > > > > > Regarding the Chinese translation project, I agree with Ken's
> > > opinion.
> > > > > >
> > > > > > From the point of my translation experience, translation is a
> work
> > > that
> > > > > > need to understand the original English sentence correctly and
> then
> > > > > express
> > > > > > it in Chinese in an easily understandable way. This is not a
> simple
> > > > work
> > > > > > that translate word by word. The one we need is not a
> "professional
> > > > > > translator",
> > > > > > but a "technical writer who are familiar with both languages".  I
> > > also
> > > > > > agree that the writer who write the initial documentation has the
> > > > better
> > > > > > ability than
> > > > > > translator to distill complex technical concepts.
> > > > > >
> > > > > > [1]: https://flink-china.org/doc/blink
> > > > > >
> > > > > > On Fri, 12 Apr 2019 at 02:40, Ken Krugler <
> > > [hidden email]
> > > > >
> > > > > > wrote:
> > > > > >
> > > > > > > Hi Konstantin,
> > > > > > >
> > > > > > > Comments inline below…
> > > > > > >
> > > > > > > — Ken
> > > > > > >
> > > > > > > > On Apr 11, 2019, at 9:05 AM, Konstantin Knauf <
> > > > > > [hidden email]>
> > > > > > > wrote:
> > > > > > > >
> > > > > > > > Hi everyone,
> > > > > > > >
> > > > > > > > I will start going through the registration process tomorrow
> > > (CET).
> > > > > > > > Jincheng (cc) reached out to me directly and offered to be
> the
> > > > second
> > > > > > > > organization administrator. So, we are all set in that
> regard.
> > > > > > > >
> > > > > > > > In terms of mentors, we now have
> > > > > > > >
> > > > > > > > * myself
> > > > > > > > * Fabian
> > > > > > > > * David
> > > > > > > > * Stephan
> > > > > > > > * Jark (Chinese Translation)
> > > > > > > >
> > > > > > > > Regarding the Chinese translation project, it is probably a
> > > > question
> > > > > of
> > > > > > > how
> > > > > > > > independent the Chinese version is supposed to be. If the
> > English
> > > > > > > > documentation is the ground-truth and the Chinese
> documentation
> > > is
> > > > > > > (mainly)
> > > > > > > > a translation, I agree with Stefan. If the Chinese
> > documentation
> > > is
> > > > > > > > supposed to become an independent secondary documentation, it
> > > could
> > > > > be
> > > > > > a
> > > > > > > > project for a technical writer as well. Has this questions
> > > already
> > > > > been
> > > > > > > > discussed in the community?
> > > > > > >
> > > > > > > My understanding is that the Chinese documentation is going to
> > > mostly
> > > > > be
> > > > > > a
> > > > > > > translation of the English versions.
> > > > > > >
> > > > > > > Though perhaps, with all of the Blink integration going on, the
> > > > inverse
> > > > > > > could also be true.
> > > > > > >
> > > > > > > Does anyone from the Blink team have input on whether there is
> > > > > existing,
> > > > > > > original Chinese documentation which should be translated to
> > > English?
> > > > > > >
> > > > > > > > On Thu, Apr 11, 2019 at 11:34 AM Stephan Ewen <
> > [hidden email]>
> > > > > > wrote:
> > > > > > > >
> > > > > > > >> So we have two ideas for docs projects now:
> > > > > > > >>
> > > > > > > >> (1) Create or rework setup / tutorials / concepts docs
> > > > > > > >> (2) Complete (or advance) the Chinese translation
> > > > > > > >>
> > > > > > > >> Should we apply for both (and let the SoD committee select
> > > > whichever
> > > > > > > they
> > > > > > > >> want to sponsor) or select one of them?
> > > > > > > >>
> > > > > > > >> For project (2), this sounds to me more like a project for a
> > > > > > > "translator",
> > > > > > > >> not a "technical writer". As far as I understand it, the big
> > > > benefit
> > > > > > of
> > > > > > > >> having a technical writer is to have someone who can
> describe
> > > > > > > complicated
> > > > > > > >> technical concepts (that engineers describe in complicated
> > > > language)
> > > > > > in
> > > > > > > an
> > > > > > > >> easily understandable way.
> > > > > > >
> > > > > > > Actually a good Chinese translation of the technical docs
> > requires
> > > > > > someone
> > > > > > > with many of the same skills. In order for the translation to
> be
> > > > > > accurate,
> > > > > > > you need someone who understands the concepts of the underlying
> > > > > > technology,
> > > > > > > to use appropriate terminology. Though I agree that the ability
> > to
> > > > > > distill
> > > > > > > complex technical concepts is more important when writing
> initial
> > > > > > > documentation.
> > > > > > >
> > > > > > >
> > > > > > > >> On Thu, Apr 11, 2019 at 9:47 AM Fabian Hueske <
> > > [hidden email]>
> > > > > > > wrote:
> > > > > > > >>
> > > > > > > >>> Thanks for the clarification Aizhamal!
> > > > > > > >>> This is really helpful and will make it a lot easier to
> > > > coordinate
> > > > > > :-)
> > > > > > > >>>
> > > > > > > >>> As for next steps, I found this email on the
> > > > > > [hidden email]
> > > > > > > >>> mailing list:
> > > > > > > >>>
> > > > > > > >>> ==================================================
> > > > > > > >>> Hi All,
> > > > > > > >>>
> > > > > > > >>> As mentioned the applications for the Google Season of Docs
> > > > opened
> > > > > > > today
> > > > > > > >>> and I'm working my way through it on behalf of the ASF.
> > > > > > > >>>
> > > > > > > >>> If accepted, we will be allocated either one or two
> techical
> > > > > writers.
> > > > > > > >>> Google will also pay the ASF a stipend of $500 per
> technical
> > > > writer
> > > > > > > >>> mentored (which I hope can go directly to fundraising :-)
> > > > > > > >>>
> > > > > > > >>> Each project that wants to participate must provide two
> > mentors
> > > > for
> > > > > > > each
> > > > > > > >>> documentation project.
> > > > > > > >>>
> > > > > > > >>> As part of the application process there are a few things
> > that
> > > we
> > > > > > need
> > > > > > > to
> > > > > > > >>> setup.
> > > > > > > >>>
> > > > > > > >>> 1. Season of Docs Page and List of Project Ideas
> > > > > > > >>> We need to create a public webpage about Season of Docs
> that
> > > > > contains
> > > > > > > the
> > > > > > > >>> list of project ideas for documentation. I have created a
> > page
> > > on
> > > > > the
> > > > > > > >>> ComDev wiki https://s.apache.org/w4CH  with a table for
> > > projects
> > > > > to
> > > > > > > >> record
> > > > > > > >>> their ideas.
> > > > > > > >>>
> > > > > > > >>> 2. Alternative administrator.
> > > > > > > >>> I’ve set myself up as the primary admin and Maxim as the
> > > > > alternative
> > > > > > > >> admin
> > > > > > > >>> (Maxim, I need to confirm your contact email and you will
> > also
> > > > need
> > > > > > to
> > > > > > > >>> register as the alternative admin and I will email you the
> > link
> > > > > > > offline)
> > > > > > > >>>
> > > > > > > >>> 3. Mentors
> > > > > > > >>> All mentors from the projects interested in participating
> > must
> > > > > > register
> > > > > > > >>> individually at the following link :
> > > > > > > https://forms.gle/a1x26WQGzURLerv66
> > > > > > > >> .
> > > > > > > >>>
> > > > > > > >>> 4. Application Form: Documentation / Technnial Writer
> > > > Collaboration
> > > > > > > >>> There is a section to fill in about experience with
> > > documentation
> > > > > and
> > > > > > > any
> > > > > > > >>> previous collaboration with technical writers. I know a few
> > > > > projects
> > > > > > > have
> > > > > > > >>> used various tools for documentation - but not sure about
> any
> > > > > > technical
> > > > > > > >>> writing collaboration (so if you know of any then please
> let
> > me
> > > > > know)
> > > > > > > >>>
> > > > > > > >>> 5. Application Form: GSoC
> > > > > > > >>> There is a section to complete at our participation in
> GSoC.I
> > > > > think I
> > > > > > > >> have
> > > > > > > >>> the details from our application this year so can follow up
> > > with
> > > > > > Maxim
> > > > > > > or
> > > > > > > >>> Uli about it
> > > > > > > >>>
> > > > > > > >>> This is all I have at the moment and we have until the 23rd
> > > April
> > > > > > 2019
> > > > > > > to
> > > > > > > >>> finalise all the application details. Ideally I want to
> have
> > it
> > > > > done
> > > > > > > well
> > > > > > > >>> before then :-)
> > > > > > > >>>
> > > > > > > >>> Please pass on this information within your various
> projects
> > > and
> > > > as
> > > > > > > with
> > > > > > > >>> GSoC - I'll see how we can get this information out to all
> > our
> > > > > > project
> > > > > > > >>> mailing lists.
> > > > > > > >>>
> > > > > > > >>> Thanks
> > > > > > > >>> Sharan
> > > > > > > >>>
> > > > > > > >>> ==================================================
> > > > > > > >>>
> > > > > > > >>> I guess, we would need to follow these steps as well.
> > > > > > > >>>
> > > > > > > >>> Best,
> > > > > > > >>> Fabian
> > > > > > > >>>
> > > > > > > >>> Am Do., 11. Apr. 2019 um 05:08 Uhr schrieb Jark Wu <
> > > > > [hidden email]
> > > > > > >:
> > > > > > > >>>
> > > > > > > >>>> Hi Aizhamal,
> > > > > > > >>>>
> > > > > > > >>>> That's really interesting. We have an ongoing proposal for
> > > > > > supporting
> > > > > > > >>>> Chinese documentation, see FLIP-35 [1].
> > > > > > > >>>>
> > > > > > > >>>> I think it's a good idea to propose Chinese translation
> as a
> > > > > > project.
> > > > > > > >>> It's
> > > > > > > >>>> a good chance to improve the localization user experience
> of
> > > > Flink
> > > > > > > >>>> documentation.
> > > > > > > >>>> I can help as a mentor if we want to submit such a
> project.
> > > > > > > >>>>
> > > > > > > >>>> Thanks,
> > > > > > > >>>> Jark Wu
> > > > > > > >>>>
> > > > > > > >>>> [1]:
> > > > > > > >>>>
> > > > > > > >>>
> > > > > > > >>
> > > > > > >
> > > > > >
> > > > >
> > > >
> > >
> >
> https://cwiki.apache.org/confluence/display/FLINK/FLIP-35%3A+Support+Chinese+Documents+and+Website
> > > > > > > >>>>
> > > > > > > >>>> On Thu, 11 Apr 2019 at 02:11, Aizhamal Nurmamat kyzy
> > > > > > > >>>> <[hidden email]> wrote:
> > > > > > > >>>>
> > > > > > > >>>>> Hello everyone,
> > > > > > > >>>>>
> > > > > > > >>>>> @Fabian Hueske <[hidden email]> - SoD setup is a
> little
> > > bit
> > > > > > > >>> different.
> > > > > > > >>>>> The ASF determined that each project would be allowed to
> > > apply
> > > > > > > >>>>> individually[1], rather than applying as a single large
> > > > > > organization.
> > > > > > > >>>>>
> > > > > > > >>>>> Each project applies as an org, with two organizers
> > > > (administers)
> > > > > > and
> > > > > > > >> at
> > > > > > > >>>>> least two mentors. As Konstantin pointed out, one can be
> > both
> > > > an
> > > > > > > >>>>> administer
> > > > > > > >>>>> and a mentor. You don't need to coordinate with other
> > > projects
> > > > or
> > > > > > ASF
> > > > > > > >> at
> > > > > > > >>>>> all. If accepted to the program, you will receive project
> > > > > proposals
> > > > > > > >> from
> > > > > > > >>>>> tech writers [2]. You will choose one or two proposals
> that
> > > you
> > > > > > want
> > > > > > > >> to
> > > > > > > >>>>> mentor[3].
> > > > > > > >>>>>
> > > > > > > >>>>> @Ken - as for the language, there isn’t any limitations
> in
> > > that
> > > > > > > >> regard,
> > > > > > > >>> so
> > > > > > > >>>>> work on the Chinese translation for the website is
> > definitely
> > > > an
> > > > > > > >>>>> acceptable
> > > > > > > >>>>> project.
> > > > > > > >>>>>
> > > > > > > >>>>> Thanks,
> > > > > > > >>>>>
> > > > > > > >>>>> Aizhamal
> > > > > > > >>>>>
> > > > > > > >>>>>
> > > > > > > >>>>> [1]
> > > > > > > >>>>>
> > > > > > > >>>>>
> > > > > > > >>>
> > > > > > > >>
> > > > > > >
> > > > > >
> > > > >
> > > >
> > >
> >
> https://lists.apache.org/thread.html/67e1c2e6041cff1e7f198b615407401f032795130e796adfaacf8071@%3Cdev.community.apache.org%3E
> > > > > > > >>>>>
> > > > > > > >>>>> [2] https://developers.google.com/season-of-docs/docs/
> > > > > > > >>>>>
> > > > > > > >>>>> [3]
> > > > > > > >>>
> > > > > >
> > > https://developers.google.com/season-of-docs/docs/faq#slot-allocation
> > > > > > > >>>>>
> > > > > > > >>>>>
> > > > > > > >>>>> On Wed, Apr 10, 2019 at 8:32 AM Ken Krugler <
> > > > > > > >>> [hidden email]>
> > > > > > > >>>>> wrote:
> > > > > > > >>>>>
> > > > > > > >>>>>> Hi Aizhamal,
> > > > > > > >>>>>>
> > > > > > > >>>>>> I assume SoD is language-agnostic, so one possible
> project
> > > > would
> > > > > > be
> > > > > > > >> to
> > > > > > > >>>>> get
> > > > > > > >>>>>> a tech writer for the Chinese versions of all of the
> Flink
> > > > > > > >>>>> documentation,
> > > > > > > >>>>>> yes?
> > > > > > > >>>>>>
> > > > > > > >>>>>> Regards,
> > > > > > > >>>>>>
> > > > > > > >>>>>> — Ken
> > > > > > > >>>>>>
> > > > > > > >>>>>>> On Apr 5, 2019, at 3:43 PM, Aizhamal Nurmamat kyzy
> > > > > > > >>>>>> <[hidden email]> wrote:
> > > > > > > >>>>>>>
> > > > > > > >>>>>>> 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
> > > > > > >
> > > > > > > --------------------------
> > > > > > > Ken Krugler
> > > > > > > [phone]
> > > > > > > http://www.scaleunlimited.com
> > > > > > > Custom big data solutions & training
> > > > > > > Flink, Solr, Hadoop, Cascading & Cassandra
> > > > > > >
> > > > > > >
> > > > > >
> > > > >
> > > >
> > >
> >
>

--

Konstantin Knauf | Solutions Architect

[phone]

<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

[Aizhamal Nurmamat kyzy]

Hello everyone,

@Konstantin Knauf <[hidden email]> - yes, you are correct.
Between steps 1 and 2 though, the open source organization, in this case
Flink, has to be selected by SoD as one of the participating orgs *fingers
crossed*.

One tip about organizing ideas is that you want to communicate potential
projects to the tech writers that are applying. Just make sure the scope of
the project is clear to them. The SoD wants to set up the tech writers for
success by making sure the work can be done in the allotted time.

Hope it helps.

Aizhamal



On Fri, Apr 12, 2019 at 7:37 AM Konstantin Knauf <[hidden email]>
wrote:

> Hi all,
>
> I read through the SoD documentation again, and now I think, it would
> actually make sense to split (1) up into multiple project ideas. Let me
> summarize the overall process:
>
> 1. We create & publish a list of project ideas, e.g. in a blog post. (This
> can be any number of ideas.)
> 2. Potential technical writers look at our list of ideas and sent a
> proposal for a particular project to Google. During that time they can
> reach out to us for clarification.
> 3. Google forwards all proposals for our project ideas to us and we sent
> back a prioritized list of proposals, which we would like to accept.
> 4. Of all these proposals, Google accepts 50 proposals for SoD 2019. Per
> organization Google will only accept a maximum of two proposals.
>
> @Aizhamal Nurmamat kyzy <[hidden email]> Please correct me!
>
> For me this means we should splits this up in a way, that each project is
> a) still relevant in September b) makes sense as a 3 month project. Based
> on the ideas we have right now these could for example be:
>
> (I) Rework/Extract/Improve the documentation of stream processing concepts
> (II) Improve & extend Apache Flink's documentation for deployment,
> operations (incl. configuration)
> (III) Add documentation for Flink internals
> (IV) Rework Table API / SQL documentation
>
> We would then get proposals potentially for all of these topics and could
> decide which of these proposals, we would sent back to Google. My feeling
> is that a technical writer could easily spent three months on any of these
> projects. What do others think? Any other project ideas?
>
> Cheers,
>
> Konstantin
>
>
>
>
> On Fri, Apr 12, 2019 at 1:47 PM Jark Wu <[hidden email]> wrote:
>
>> Hi all,
>>
>> I'm fine with only preparing the first proposal. I think it's reasonable
>> because the first proposal is more attractive
>> and maybe there is not enough Chinese writer. We can focus on one project
>> to come up with a concrete and
>> attractive project plan.
>>
>> One possible subproject could be rework Table SQL docs.
>> (1). Improve concepts in Table SQL.
>> (2). A more detailed introduction of built-in functions, currently we only
>> have a simple explanation for each function.
>>       We should add more descriptions, especially more concrete examples,
>> and maybe some notes. We can take
>>       MySQL doc [1] as a reference.
>> (3). As Flink SQL is evolving rapidly and features from Blink is being
>> merged,  for example, SQL DDL, Hive integration,
>>       Python Table API, Interactive Programing, SQL optimization and
>> tuning, etc... We can redesign the doc structure of
>>       Table SQL in a higher vision.
>>
>> Cheers,
>> Jark
>>
>> [1]:
>> https://dev.mysql.com/doc/refman/5.7/en/string-functions.html#function_bin
>>
>>
>>
>> On Fri, 12 Apr 2019 at 18:19, jincheng sun <[hidden email]>
>> wrote:
>>
>> > I am honored to have the opportunity to do a second organization
>> > administrator‘s works!
>> >
>> > It seems that one project and multiple projects have their own
>> advantages.
>> >
>> > My understanding is that even if we only have one project, we also can
>> have
>> > multiple mentors and recruit enough writers.
>> >
>> > Fabian Hueske <[hidden email]> 于2019年4月12日周五 下午5:57写道：
>> >
>> > > Yes, I think we would get at most one project accepted.
>> > > Having all options in a rather generic proposal gives us the most
>> > > flexibility to decide what to work on once the proposal is accepted.
>> > > On the other hand, a more concrete proposal might look more attractive
>> > for
>> > > candidates.
>> > > I'm fine either way, but my gut feeling is that a well scoped proposal
>> > > gives better changes of finding a writer (which might be the biggest
>> > > challenge).
>> > >
>> > > Am Fr., 12. Apr. 2019 um 11:39 Uhr schrieb Stephan Ewen <
>> > [hidden email]
>> > > >:
>> > >
>> > > > I would suggest to make one proposal and have the subsections only
>> in
>> > the
>> > > > project plan.
>> > > > My understanding is that we need to indicate priorities between
>> > proposals
>> > > > and might get only one, so it would be good to not subdivide.
>> > > >
>> > > > On Fri, Apr 12, 2019 at 9:58 AM Fabian Hueske <[hidden email]>
>> > wrote:
>> > > >
>> > > > > Hi everyone,
>> > > > >
>> > > > > I think we can split the first project that Stephan proposed into
>> > > smaller
>> > > > > ones:
>> > > > >
>> > > > > > (1) Create or rework setup / tutorials / concepts docs
>> > > > > > (2) Complete (or advance) the Chinese translation
>> > > > >
>> > > > > 1.1 Improving (extracting) the documentation of stream processing
>> > > > concepts:
>> > > > > Event-time, Timers, State, State Backends, Checkpointing,
>> Savepoints
>> > > > > Right now, the relevant information is scattered across several
>> pages
>> > > and
>> > > > > mixed with the implementation / APIs / configuration options.
>> > > > >
>> > > > > 1.2 Improving & extending the documentation of deployments
>> > > > >
>> > > > > 1.3 Adding documentation in the internals: Distributed
>> architecture,
>> > > > > recovery, operators, job translation, execution, etc.
>> > > > > This documentation would be targeted to Flink developers.
>> > > > >
>> > > > > I thought again about the idea of improving the tutorials, and
>> I'm no
>> > > > > longer sure if this would fit SoD well.
>> > > > > The reason is that creating good tutorials requires a good
>> portion of
>> > > > > coding / configuration (creating Docker images, example programs,
>> > > etc.).
>> > > > > Also I'd like to start improving the situation of tutorials
>> earlier
>> > > than
>> > > > > September.
>> > > > >
>> > > > > What do others think?
>> > > > >
>> > > > > Cheers, Fabian
>> > > > >
>> > > > >
>> > > > > Am Fr., 12. Apr. 2019 um 04:29 Uhr schrieb Jark Wu <
>> [hidden email]
>> > >:
>> > > > >
>> > > > > > Hi Konstantin, Ken,
>> > > > > >
>> > > > > > I agree that Chinese documentation is mainly a translation.
>> > > > > >
>> > > > > > >  Does anyone from the Blink team have input on whether there
>> is
>> > > > > existing,
>> > > > > > original Chinese documentation which should be translated to
>> > English?
>> > > > > >
>> > > > > > There is a public Blink documentation [1] which is English.
>> > > > > > We have a Blink Chinese documentation in internal, but I think
>> we
>> > > need
>> > > > to
>> > > > > > rewrite it in English and restructure it when contributing
>> Blink to
>> > > > > Flink.
>> > > > > >
>> > > > > > Regarding the Chinese translation project, I agree with Ken's
>> > > opinion.
>> > > > > >
>> > > > > > From the point of my translation experience, translation is a
>> work
>> > > that
>> > > > > > need to understand the original English sentence correctly and
>> then
>> > > > > express
>> > > > > > it in Chinese in an easily understandable way. This is not a
>> simple
>> > > > work
>> > > > > > that translate word by word. The one we need is not a
>> "professional
>> > > > > > translator",
>> > > > > > but a "technical writer who are familiar with both languages".
>> I
>> > > also
>> > > > > > agree that the writer who write the initial documentation has
>> the
>> > > > better
>> > > > > > ability than
>> > > > > > translator to distill complex technical concepts.
>> > > > > >
>> > > > > > [1]: https://flink-china.org/doc/blink
>> > > > > >
>> > > > > > On Fri, 12 Apr 2019 at 02:40, Ken Krugler <
>> > > [hidden email]
>> > > > >
>> > > > > > wrote:
>> > > > > >
>> > > > > > > Hi Konstantin,
>> > > > > > >
>> > > > > > > Comments inline below…
>> > > > > > >
>> > > > > > > — Ken
>> > > > > > >
>> > > > > > > > On Apr 11, 2019, at 9:05 AM, Konstantin Knauf <
>> > > > > > [hidden email]>
>> > > > > > > wrote:
>> > > > > > > >
>> > > > > > > > Hi everyone,
>> > > > > > > >
>> > > > > > > > I will start going through the registration process tomorrow
>> > > (CET).
>> > > > > > > > Jincheng (cc) reached out to me directly and offered to be
>> the
>> > > > second
>> > > > > > > > organization administrator. So, we are all set in that
>> regard.
>> > > > > > > >
>> > > > > > > > In terms of mentors, we now have
>> > > > > > > >
>> > > > > > > > * myself
>> > > > > > > > * Fabian
>> > > > > > > > * David
>> > > > > > > > * Stephan
>> > > > > > > > * Jark (Chinese Translation)
>> > > > > > > >
>> > > > > > > > Regarding the Chinese translation project, it is probably a
>> > > > question
>> > > > > of
>> > > > > > > how
>> > > > > > > > independent the Chinese version is supposed to be. If the
>> > English
>> > > > > > > > documentation is the ground-truth and the Chinese
>> documentation
>> > > is
>> > > > > > > (mainly)
>> > > > > > > > a translation, I agree with Stefan. If the Chinese
>> > documentation
>> > > is
>> > > > > > > > supposed to become an independent secondary documentation,
>> it
>> > > could
>> > > > > be
>> > > > > > a
>> > > > > > > > project for a technical writer as well. Has this questions
>> > > already
>> > > > > been
>> > > > > > > > discussed in the community?
>> > > > > > >
>> > > > > > > My understanding is that the Chinese documentation is going to
>> > > mostly
>> > > > > be
>> > > > > > a
>> > > > > > > translation of the English versions.
>> > > > > > >
>> > > > > > > Though perhaps, with all of the Blink integration going on,
>> the
>> > > > inverse
>> > > > > > > could also be true.
>> > > > > > >
>> > > > > > > Does anyone from the Blink team have input on whether there is
>> > > > > existing,
>> > > > > > > original Chinese documentation which should be translated to
>> > > English?
>> > > > > > >
>> > > > > > > > On Thu, Apr 11, 2019 at 11:34 AM Stephan Ewen <
>> > [hidden email]>
>> > > > > > wrote:
>> > > > > > > >
>> > > > > > > >> So we have two ideas for docs projects now:
>> > > > > > > >>
>> > > > > > > >> (1) Create or rework setup / tutorials / concepts docs
>> > > > > > > >> (2) Complete (or advance) the Chinese translation
>> > > > > > > >>
>> > > > > > > >> Should we apply for both (and let the SoD committee select
>> > > > whichever
>> > > > > > > they
>> > > > > > > >> want to sponsor) or select one of them?
>> > > > > > > >>
>> > > > > > > >> For project (2), this sounds to me more like a project for
>> a
>> > > > > > > "translator",
>> > > > > > > >> not a "technical writer". As far as I understand it, the
>> big
>> > > > benefit
>> > > > > > of
>> > > > > > > >> having a technical writer is to have someone who can
>> describe
>> > > > > > > complicated
>> > > > > > > >> technical concepts (that engineers describe in complicated
>> > > > language)
>> > > > > > in
>> > > > > > > an
>> > > > > > > >> easily understandable way.
>> > > > > > >
>> > > > > > > Actually a good Chinese translation of the technical docs
>> > requires
>> > > > > > someone
>> > > > > > > with many of the same skills. In order for the translation to
>> be
>> > > > > > accurate,
>> > > > > > > you need someone who understands the concepts of the
>> underlying
>> > > > > > technology,
>> > > > > > > to use appropriate terminology. Though I agree that the
>> ability
>> > to
>> > > > > > distill
>> > > > > > > complex technical concepts is more important when writing
>> initial
>> > > > > > > documentation.
>> > > > > > >
>> > > > > > >
>> > > > > > > >> On Thu, Apr 11, 2019 at 9:47 AM Fabian Hueske <
>> > > [hidden email]>
>> > > > > > > wrote:
>> > > > > > > >>
>> > > > > > > >>> Thanks for the clarification Aizhamal!
>> > > > > > > >>> This is really helpful and will make it a lot easier to
>> > > > coordinate
>> > > > > > :-)
>> > > > > > > >>>
>> > > > > > > >>> As for next steps, I found this email on the
>> > > > > > [hidden email]
>> > > > > > > >>> mailing list:
>> > > > > > > >>>
>> > > > > > > >>> ==================================================
>> > > > > > > >>> Hi All,
>> > > > > > > >>>
>> > > > > > > >>> As mentioned the applications for the Google Season of
>> Docs
>> > > > opened
>> > > > > > > today
>> > > > > > > >>> and I'm working my way through it on behalf of the ASF.
>> > > > > > > >>>
>> > > > > > > >>> If accepted, we will be allocated either one or two
>> techical
>> > > > > writers.
>> > > > > > > >>> Google will also pay the ASF a stipend of $500 per
>> technical
>> > > > writer
>> > > > > > > >>> mentored (which I hope can go directly to fundraising :-)
>> > > > > > > >>>
>> > > > > > > >>> Each project that wants to participate must provide two
>> > mentors
>> > > > for
>> > > > > > > each
>> > > > > > > >>> documentation project.
>> > > > > > > >>>
>> > > > > > > >>> As part of the application process there are a few things
>> > that
>> > > we
>> > > > > > need
>> > > > > > > to
>> > > > > > > >>> setup.
>> > > > > > > >>>
>> > > > > > > >>> 1. Season of Docs Page and List of Project Ideas
>> > > > > > > >>> We need to create a public webpage about Season of Docs
>> that
>> > > > > contains
>> > > > > > > the
>> > > > > > > >>> list of project ideas for documentation. I have created a
>> > page
>> > > on
>> > > > > the
>> > > > > > > >>> ComDev wiki https://s.apache.org/w4CH  with a table for
>> > > projects
>> > > > > to
>> > > > > > > >> record
>> > > > > > > >>> their ideas.
>> > > > > > > >>>
>> > > > > > > >>> 2. Alternative administrator.
>> > > > > > > >>> I’ve set myself up as the primary admin and Maxim as the
>> > > > > alternative
>> > > > > > > >> admin
>> > > > > > > >>> (Maxim, I need to confirm your contact email and you will
>> > also
>> > > > need
>> > > > > > to
>> > > > > > > >>> register as the alternative admin and I will email you the
>> > link
>> > > > > > > offline)
>> > > > > > > >>>
>> > > > > > > >>> 3. Mentors
>> > > > > > > >>> All mentors from the projects interested in participating
>> > must
>> > > > > > register
>> > > > > > > >>> individually at the following link :
>> > > > > > > https://forms.gle/a1x26WQGzURLerv66
>> > > > > > > >> .
>> > > > > > > >>>
>> > > > > > > >>> 4. Application Form: Documentation / Technnial Writer
>> > > > Collaboration
>> > > > > > > >>> There is a section to fill in about experience with
>> > > documentation
>> > > > > and
>> > > > > > > any
>> > > > > > > >>> previous collaboration with technical writers. I know a
>> few
>> > > > > projects
>> > > > > > > have
>> > > > > > > >>> used various tools for documentation - but not sure about
>> any
>> > > > > > technical
>> > > > > > > >>> writing collaboration (so if you know of any then please
>> let
>> > me
>> > > > > know)
>> > > > > > > >>>
>> > > > > > > >>> 5. Application Form: GSoC
>> > > > > > > >>> There is a section to complete at our participation in
>> GSoC.I
>> > > > > think I
>> > > > > > > >> have
>> > > > > > > >>> the details from our application this year so can follow
>> up
>> > > with
>> > > > > > Maxim
>> > > > > > > or
>> > > > > > > >>> Uli about it
>> > > > > > > >>>
>> > > > > > > >>> This is all I have at the moment and we have until the
>> 23rd
>> > > April
>> > > > > > 2019
>> > > > > > > to
>> > > > > > > >>> finalise all the application details. Ideally I want to
>> have
>> > it
>> > > > > done
>> > > > > > > well
>> > > > > > > >>> before then :-)
>> > > > > > > >>>
>> > > > > > > >>> Please pass on this information within your various
>> projects
>> > > and
>> > > > as
>> > > > > > > with
>> > > > > > > >>> GSoC - I'll see how we can get this information out to all
>> > our
>> > > > > > project
>> > > > > > > >>> mailing lists.
>> > > > > > > >>>
>> > > > > > > >>> Thanks
>> > > > > > > >>> Sharan
>> > > > > > > >>>
>> > > > > > > >>> ==================================================
>> > > > > > > >>>
>> > > > > > > >>> I guess, we would need to follow these steps as well.
>> > > > > > > >>>
>> > > > > > > >>> Best,
>> > > > > > > >>> Fabian
>> > > > > > > >>>
>> > > > > > > >>> Am Do., 11. Apr. 2019 um 05:08 Uhr schrieb Jark Wu <
>> > > > > [hidden email]
>> > > > > > >:
>> > > > > > > >>>
>> > > > > > > >>>> Hi Aizhamal,
>> > > > > > > >>>>
>> > > > > > > >>>> That's really interesting. We have an ongoing proposal
>> for
>> > > > > > supporting
>> > > > > > > >>>> Chinese documentation, see FLIP-35 [1].
>> > > > > > > >>>>
>> > > > > > > >>>> I think it's a good idea to propose Chinese translation
>> as a
>> > > > > > project.
>> > > > > > > >>> It's
>> > > > > > > >>>> a good chance to improve the localization user
>> experience of
>> > > > Flink
>> > > > > > > >>>> documentation.
>> > > > > > > >>>> I can help as a mentor if we want to submit such a
>> project.
>> > > > > > > >>>>
>> > > > > > > >>>> Thanks,
>> > > > > > > >>>> Jark Wu
>> > > > > > > >>>>
>> > > > > > > >>>> [1]:
>> > > > > > > >>>>
>> > > > > > > >>>
>> > > > > > > >>
>> > > > > > >
>> > > > > >
>> > > > >
>> > > >
>> > >
>> >
>> https://cwiki.apache.org/confluence/display/FLINK/FLIP-35%3A+Support+Chinese+Documents+and+Website
>> > > > > > > >>>>
>> > > > > > > >>>> On Thu, 11 Apr 2019 at 02:11, Aizhamal Nurmamat kyzy
>> > > > > > > >>>> <[hidden email]> wrote:
>> > > > > > > >>>>
>> > > > > > > >>>>> Hello everyone,
>> > > > > > > >>>>>
>> > > > > > > >>>>> @Fabian Hueske <[hidden email]> - SoD setup is a
>> little
>> > > bit
>> > > > > > > >>> different.
>> > > > > > > >>>>> The ASF determined that each project would be allowed to
>> > > apply
>> > > > > > > >>>>> individually[1], rather than applying as a single large
>> > > > > > organization.
>> > > > > > > >>>>>
>> > > > > > > >>>>> Each project applies as an org, with two organizers
>> > > > (administers)
>> > > > > > and
>> > > > > > > >> at
>> > > > > > > >>>>> least two mentors. As Konstantin pointed out, one can be
>> > both
>> > > > an
>> > > > > > > >>>>> administer
>> > > > > > > >>>>> and a mentor. You don't need to coordinate with other
>> > > projects
>> > > > or
>> > > > > > ASF
>> > > > > > > >> at
>> > > > > > > >>>>> all. If accepted to the program, you will receive
>> project
>> > > > > proposals
>> > > > > > > >> from
>> > > > > > > >>>>> tech writers [2]. You will choose one or two proposals
>> that
>> > > you
>> > > > > > want
>> > > > > > > >> to
>> > > > > > > >>>>> mentor[3].
>> > > > > > > >>>>>
>> > > > > > > >>>>> @Ken - as for the language, there isn’t any limitations
>> in
>> > > that
>> > > > > > > >> regard,
>> > > > > > > >>> so
>> > > > > > > >>>>> work on the Chinese translation for the website is
>> > definitely
>> > > > an
>> > > > > > > >>>>> acceptable
>> > > > > > > >>>>> project.
>> > > > > > > >>>>>
>> > > > > > > >>>>> Thanks,
>> > > > > > > >>>>>
>> > > > > > > >>>>> Aizhamal
>> > > > > > > >>>>>
>> > > > > > > >>>>>
>> > > > > > > >>>>> [1]
>> > > > > > > >>>>>
>> > > > > > > >>>>>
>> > > > > > > >>>
>> > > > > > > >>
>> > > > > > >
>> > > > > >
>> > > > >
>> > > >
>> > >
>> >
>> https://lists.apache.org/thread.html/67e1c2e6041cff1e7f198b615407401f032795130e796adfaacf8071@%3Cdev.community.apache.org%3E
>> > > > > > > >>>>>
>> > > > > > > >>>>> [2] https://developers.google.com/season-of-docs/docs/
>> > > > > > > >>>>>
>> > > > > > > >>>>> [3]
>> > > > > > > >>>
>> > > > > >
>> > > https://developers.google.com/season-of-docs/docs/faq#slot-allocation
>> > > > > > > >>>>>
>> > > > > > > >>>>>
>> > > > > > > >>>>> On Wed, Apr 10, 2019 at 8:32 AM Ken Krugler <
>> > > > > > > >>> [hidden email]>
>> > > > > > > >>>>> wrote:
>> > > > > > > >>>>>
>> > > > > > > >>>>>> Hi Aizhamal,
>> > > > > > > >>>>>>
>> > > > > > > >>>>>> I assume SoD is language-agnostic, so one possible
>> project
>> > > > would
>> > > > > > be
>> > > > > > > >> to
>> > > > > > > >>>>> get
>> > > > > > > >>>>>> a tech writer for the Chinese versions of all of the
>> Flink
>> > > > > > > >>>>> documentation,
>> > > > > > > >>>>>> yes?
>> > > > > > > >>>>>>
>> > > > > > > >>>>>> Regards,
>> > > > > > > >>>>>>
>> > > > > > > >>>>>> — Ken
>> > > > > > > >>>>>>
>> > > > > > > >>>>>>> On Apr 5, 2019, at 3:43 PM, Aizhamal Nurmamat kyzy
>> > > > > > > >>>>>> <[hidden email]> wrote:
>> > > > > > > >>>>>>>
>> > > > > > > >>>>>>> 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
>> > > > > > >
>> > > > > > > --------------------------
>> > > > > > > Ken Krugler
>> > > > > > > [phone]
>> > > > > > > http://www.scaleunlimited.com
>> > > > > > > Custom big data solutions & training
>> > > > > > > Flink, Solr, Hadoop, Cascading & Cassandra
>> > > > > > >
>> > > > > > >
>> > > > > >
>> > > > >
>> > > >
>> > >
>> >
>>
>
>
> --
>
> Konstantin Knauf | Solutions Architect
>
> [phone]
>
> <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
>

[Konstantin Knauf-3]

Hi everyone,

thanks @Aizhamal Nurmamat kyzy <[hidden email]>. As we only have one
week left until the application deadline, I went ahead and created a
document for the project ideas [1]. I have added the description for the
"stream processing concepts" as well as the "deployment & operations
documentation" project idea. Please let me know what you think, edit &
comment. We also need descriptions for the other two projects (Table
API/SQL & Flink Internals). @Fabian/@Jark/@Stephan can you chime in?

Any more project ideas?

Best,

Konstantin


[1]
https://docs.google.com/document/d/1Up53jNsLztApn-mP76AB6xWUVGt3nwS9p6xQTiceKXo/edit?usp=sharing



On Fri, Apr 12, 2019 at 6:50 PM Aizhamal Nurmamat kyzy <[hidden email]>
wrote:

> Hello everyone,
>
> @Konstantin Knauf <[hidden email]> - yes, you are correct.
> Between steps 1 and 2 though, the open source organization, in this case
> Flink, has to be selected by SoD as one of the participating orgs *fingers
> crossed*.
>
> One tip about organizing ideas is that you want to communicate potential
> projects to the tech writers that are applying. Just make sure the scope of
> the project is clear to them. The SoD wants to set up the tech writers for
> success by making sure the work can be done in the allotted time.
>
> Hope it helps.
>
> Aizhamal
>
>
>
> On Fri, Apr 12, 2019 at 7:37 AM Konstantin Knauf <[hidden email]>
> wrote:
>
>> Hi all,
>>
>> I read through the SoD documentation again, and now I think, it would
>> actually make sense to split (1) up into multiple project ideas. Let me
>> summarize the overall process:
>>
>> 1. We create & publish a list of project ideas, e.g. in a blog post.
>> (This can be any number of ideas.)
>> 2. Potential technical writers look at our list of ideas and sent a
>> proposal for a particular project to Google. During that time they can
>> reach out to us for clarification.
>> 3. Google forwards all proposals for our project ideas to us and we sent
>> back a prioritized list of proposals, which we would like to accept.
>> 4. Of all these proposals, Google accepts 50 proposals for SoD 2019. Per
>> organization Google will only accept a maximum of two proposals.
>>
>> @Aizhamal Nurmamat kyzy <[hidden email]> Please correct me!
>>
>> For me this means we should splits this up in a way, that each project is
>> a) still relevant in September b) makes sense as a 3 month project. Based
>> on the ideas we have right now these could for example be:
>>
>> (I) Rework/Extract/Improve the documentation of stream processing concepts
>> (II) Improve & extend Apache Flink's documentation for deployment,
>> operations (incl. configuration)
>> (III) Add documentation for Flink internals
>> (IV) Rework Table API / SQL documentation
>>
>> We would then get proposals potentially for all of these topics and could
>> decide which of these proposals, we would sent back to Google. My feeling
>> is that a technical writer could easily spent three months on any of these
>> projects. What do others think? Any other project ideas?
>>
>> Cheers,
>>
>> Konstantin
>>
>>
>>
>>
>> On Fri, Apr 12, 2019 at 1:47 PM Jark Wu <[hidden email]> wrote:
>>
>>> Hi all,
>>>
>>> I'm fine with only preparing the first proposal. I think it's reasonable
>>> because the first proposal is more attractive
>>> and maybe there is not enough Chinese writer. We can focus on one project
>>> to come up with a concrete and
>>> attractive project plan.
>>>
>>> One possible subproject could be rework Table SQL docs.
>>> (1). Improve concepts in Table SQL.
>>> (2). A more detailed introduction of built-in functions, currently we
>>> only
>>> have a simple explanation for each function.
>>>       We should add more descriptions, especially more concrete examples,
>>> and maybe some notes. We can take
>>>       MySQL doc [1] as a reference.
>>> (3). As Flink SQL is evolving rapidly and features from Blink is being
>>> merged,  for example, SQL DDL, Hive integration,
>>>       Python Table API, Interactive Programing, SQL optimization and
>>> tuning, etc... We can redesign the doc structure of
>>>       Table SQL in a higher vision.
>>>
>>> Cheers,
>>> Jark
>>>
>>> [1]:
>>>
>>> https://dev.mysql.com/doc/refman/5.7/en/string-functions.html#function_bin
>>>
>>>
>>>
>>> On Fri, 12 Apr 2019 at 18:19, jincheng sun <[hidden email]>
>>> wrote:
>>>
>>> > I am honored to have the opportunity to do a second organization
>>> > administrator‘s works!
>>> >
>>> > It seems that one project and multiple projects have their own
>>> advantages.
>>> >
>>> > My understanding is that even if we only have one project, we also can
>>> have
>>> > multiple mentors and recruit enough writers.
>>> >
>>> > Fabian Hueske <[hidden email]> 于2019年4月12日周五 下午5:57写道：
>>> >
>>> > > Yes, I think we would get at most one project accepted.
>>> > > Having all options in a rather generic proposal gives us the most
>>> > > flexibility to decide what to work on once the proposal is accepted.
>>> > > On the other hand, a more concrete proposal might look more
>>> attractive
>>> > for
>>> > > candidates.
>>> > > I'm fine either way, but my gut feeling is that a well scoped
>>> proposal
>>> > > gives better changes of finding a writer (which might be the biggest
>>> > > challenge).
>>> > >
>>> > > Am Fr., 12. Apr. 2019 um 11:39 Uhr schrieb Stephan Ewen <
>>> > [hidden email]
>>> > > >:
>>> > >
>>> > > > I would suggest to make one proposal and have the subsections only
>>> in
>>> > the
>>> > > > project plan.
>>> > > > My understanding is that we need to indicate priorities between
>>> > proposals
>>> > > > and might get only one, so it would be good to not subdivide.
>>> > > >
>>> > > > On Fri, Apr 12, 2019 at 9:58 AM Fabian Hueske <[hidden email]>
>>> > wrote:
>>> > > >
>>> > > > > Hi everyone,
>>> > > > >
>>> > > > > I think we can split the first project that Stephan proposed into
>>> > > smaller
>>> > > > > ones:
>>> > > > >
>>> > > > > > (1) Create or rework setup / tutorials / concepts docs
>>> > > > > > (2) Complete (or advance) the Chinese translation
>>> > > > >
>>> > > > > 1.1 Improving (extracting) the documentation of stream processing
>>> > > > concepts:
>>> > > > > Event-time, Timers, State, State Backends, Checkpointing,
>>> Savepoints
>>> > > > > Right now, the relevant information is scattered across several
>>> pages
>>> > > and
>>> > > > > mixed with the implementation / APIs / configuration options.
>>> > > > >
>>> > > > > 1.2 Improving & extending the documentation of deployments
>>> > > > >
>>> > > > > 1.3 Adding documentation in the internals: Distributed
>>> architecture,
>>> > > > > recovery, operators, job translation, execution, etc.
>>> > > > > This documentation would be targeted to Flink developers.
>>> > > > >
>>> > > > > I thought again about the idea of improving the tutorials, and
>>> I'm no
>>> > > > > longer sure if this would fit SoD well.
>>> > > > > The reason is that creating good tutorials requires a good
>>> portion of
>>> > > > > coding / configuration (creating Docker images, example programs,
>>> > > etc.).
>>> > > > > Also I'd like to start improving the situation of tutorials
>>> earlier
>>> > > than
>>> > > > > September.
>>> > > > >
>>> > > > > What do others think?
>>> > > > >
>>> > > > > Cheers, Fabian
>>> > > > >
>>> > > > >
>>> > > > > Am Fr., 12. Apr. 2019 um 04:29 Uhr schrieb Jark Wu <
>>> [hidden email]
>>> > >:
>>> > > > >
>>> > > > > > Hi Konstantin, Ken,
>>> > > > > >
>>> > > > > > I agree that Chinese documentation is mainly a translation.
>>> > > > > >
>>> > > > > > >  Does anyone from the Blink team have input on whether there
>>> is
>>> > > > > existing,
>>> > > > > > original Chinese documentation which should be translated to
>>> > English?
>>> > > > > >
>>> > > > > > There is a public Blink documentation [1] which is English.
>>> > > > > > We have a Blink Chinese documentation in internal, but I think
>>> we
>>> > > need
>>> > > > to
>>> > > > > > rewrite it in English and restructure it when contributing
>>> Blink to
>>> > > > > Flink.
>>> > > > > >
>>> > > > > > Regarding the Chinese translation project, I agree with Ken's
>>> > > opinion.
>>> > > > > >
>>> > > > > > From the point of my translation experience, translation is a
>>> work
>>> > > that
>>> > > > > > need to understand the original English sentence correctly and
>>> then
>>> > > > > express
>>> > > > > > it in Chinese in an easily understandable way. This is not a
>>> simple
>>> > > > work
>>> > > > > > that translate word by word. The one we need is not a
>>> "professional
>>> > > > > > translator",
>>> > > > > > but a "technical writer who are familiar with both
>>> languages".  I
>>> > > also
>>> > > > > > agree that the writer who write the initial documentation has
>>> the
>>> > > > better
>>> > > > > > ability than
>>> > > > > > translator to distill complex technical concepts.
>>> > > > > >
>>> > > > > > [1]: https://flink-china.org/doc/blink
>>> > > > > >
>>> > > > > > On Fri, 12 Apr 2019 at 02:40, Ken Krugler <
>>> > > [hidden email]
>>> > > > >
>>> > > > > > wrote:
>>> > > > > >
>>> > > > > > > Hi Konstantin,
>>> > > > > > >
>>> > > > > > > Comments inline below…
>>> > > > > > >
>>> > > > > > > — Ken
>>> > > > > > >
>>> > > > > > > > On Apr 11, 2019, at 9:05 AM, Konstantin Knauf <
>>> > > > > > [hidden email]>
>>> > > > > > > wrote:
>>> > > > > > > >
>>> > > > > > > > Hi everyone,
>>> > > > > > > >
>>> > > > > > > > I will start going through the registration process
>>> tomorrow
>>> > > (CET).
>>> > > > > > > > Jincheng (cc) reached out to me directly and offered to be
>>> the
>>> > > > second
>>> > > > > > > > organization administrator. So, we are all set in that
>>> regard.
>>> > > > > > > >
>>> > > > > > > > In terms of mentors, we now have
>>> > > > > > > >
>>> > > > > > > > * myself
>>> > > > > > > > * Fabian
>>> > > > > > > > * David
>>> > > > > > > > * Stephan
>>> > > > > > > > * Jark (Chinese Translation)
>>> > > > > > > >
>>> > > > > > > > Regarding the Chinese translation project, it is probably a
>>> > > > question
>>> > > > > of
>>> > > > > > > how
>>> > > > > > > > independent the Chinese version is supposed to be. If the
>>> > English
>>> > > > > > > > documentation is the ground-truth and the Chinese
>>> documentation
>>> > > is
>>> > > > > > > (mainly)
>>> > > > > > > > a translation, I agree with Stefan. If the Chinese
>>> > documentation
>>> > > is
>>> > > > > > > > supposed to become an independent secondary documentation,
>>> it
>>> > > could
>>> > > > > be
>>> > > > > > a
>>> > > > > > > > project for a technical writer as well. Has this questions
>>> > > already
>>> > > > > been
>>> > > > > > > > discussed in the community?
>>> > > > > > >
>>> > > > > > > My understanding is that the Chinese documentation is going
>>> to
>>> > > mostly
>>> > > > > be
>>> > > > > > a
>>> > > > > > > translation of the English versions.
>>> > > > > > >
>>> > > > > > > Though perhaps, with all of the Blink integration going on,
>>> the
>>> > > > inverse
>>> > > > > > > could also be true.
>>> > > > > > >
>>> > > > > > > Does anyone from the Blink team have input on whether there
>>> is
>>> > > > > existing,
>>> > > > > > > original Chinese documentation which should be translated to
>>> > > English?
>>> > > > > > >
>>> > > > > > > > On Thu, Apr 11, 2019 at 11:34 AM Stephan Ewen <
>>> > [hidden email]>
>>> > > > > > wrote:
>>> > > > > > > >
>>> > > > > > > >> So we have two ideas for docs projects now:
>>> > > > > > > >>
>>> > > > > > > >> (1) Create or rework setup / tutorials / concepts docs
>>> > > > > > > >> (2) Complete (or advance) the Chinese translation
>>> > > > > > > >>
>>> > > > > > > >> Should we apply for both (and let the SoD committee select
>>> > > > whichever
>>> > > > > > > they
>>> > > > > > > >> want to sponsor) or select one of them?
>>> > > > > > > >>
>>> > > > > > > >> For project (2), this sounds to me more like a project
>>> for a
>>> > > > > > > "translator",
>>> > > > > > > >> not a "technical writer". As far as I understand it, the
>>> big
>>> > > > benefit
>>> > > > > > of
>>> > > > > > > >> having a technical writer is to have someone who can
>>> describe
>>> > > > > > > complicated
>>> > > > > > > >> technical concepts (that engineers describe in complicated
>>> > > > language)
>>> > > > > > in
>>> > > > > > > an
>>> > > > > > > >> easily understandable way.
>>> > > > > > >
>>> > > > > > > Actually a good Chinese translation of the technical docs
>>> > requires
>>> > > > > > someone
>>> > > > > > > with many of the same skills. In order for the translation
>>> to be
>>> > > > > > accurate,
>>> > > > > > > you need someone who understands the concepts of the
>>> underlying
>>> > > > > > technology,
>>> > > > > > > to use appropriate terminology. Though I agree that the
>>> ability
>>> > to
>>> > > > > > distill
>>> > > > > > > complex technical concepts is more important when writing
>>> initial
>>> > > > > > > documentation.
>>> > > > > > >
>>> > > > > > >
>>> > > > > > > >> On Thu, Apr 11, 2019 at 9:47 AM Fabian Hueske <
>>> > > [hidden email]>
>>> > > > > > > wrote:
>>> > > > > > > >>
>>> > > > > > > >>> Thanks for the clarification Aizhamal!
>>> > > > > > > >>> This is really helpful and will make it a lot easier to
>>> > > > coordinate
>>> > > > > > :-)
>>> > > > > > > >>>
>>> > > > > > > >>> As for next steps, I found this email on the
>>> > > > > > [hidden email]
>>> > > > > > > >>> mailing list:
>>> > > > > > > >>>
>>> > > > > > > >>> ==================================================
>>> > > > > > > >>> Hi All,
>>> > > > > > > >>>
>>> > > > > > > >>> As mentioned the applications for the Google Season of
>>> Docs
>>> > > > opened
>>> > > > > > > today
>>> > > > > > > >>> and I'm working my way through it on behalf of the ASF.
>>> > > > > > > >>>
>>> > > > > > > >>> If accepted, we will be allocated either one or two
>>> techical
>>> > > > > writers.
>>> > > > > > > >>> Google will also pay the ASF a stipend of $500 per
>>> technical
>>> > > > writer
>>> > > > > > > >>> mentored (which I hope can go directly to fundraising :-)
>>> > > > > > > >>>
>>> > > > > > > >>> Each project that wants to participate must provide two
>>> > mentors
>>> > > > for
>>> > > > > > > each
>>> > > > > > > >>> documentation project.
>>> > > > > > > >>>
>>> > > > > > > >>> As part of the application process there are a few things
>>> > that
>>> > > we
>>> > > > > > need
>>> > > > > > > to
>>> > > > > > > >>> setup.
>>> > > > > > > >>>
>>> > > > > > > >>> 1. Season of Docs Page and List of Project Ideas
>>> > > > > > > >>> We need to create a public webpage about Season of Docs
>>> that
>>> > > > > contains
>>> > > > > > > the
>>> > > > > > > >>> list of project ideas for documentation. I have created a
>>> > page
>>> > > on
>>> > > > > the
>>> > > > > > > >>> ComDev wiki https://s.apache.org/w4CH  with a table for
>>> > > projects
>>> > > > > to
>>> > > > > > > >> record
>>> > > > > > > >>> their ideas.
>>> > > > > > > >>>
>>> > > > > > > >>> 2. Alternative administrator.
>>> > > > > > > >>> I’ve set myself up as the primary admin and Maxim as the
>>> > > > > alternative
>>> > > > > > > >> admin
>>> > > > > > > >>> (Maxim, I need to confirm your contact email and you will
>>> > also
>>> > > > need
>>> > > > > > to
>>> > > > > > > >>> register as the alternative admin and I will email you
>>> the
>>> > link
>>> > > > > > > offline)
>>> > > > > > > >>>
>>> > > > > > > >>> 3. Mentors
>>> > > > > > > >>> All mentors from the projects interested in participating
>>> > must
>>> > > > > > register
>>> > > > > > > >>> individually at the following link :
>>> > > > > > > https://forms.gle/a1x26WQGzURLerv66
>>> > > > > > > >> .
>>> > > > > > > >>>
>>> > > > > > > >>> 4. Application Form: Documentation / Technnial Writer
>>> > > > Collaboration
>>> > > > > > > >>> There is a section to fill in about experience with
>>> > > documentation
>>> > > > > and
>>> > > > > > > any
>>> > > > > > > >>> previous collaboration with technical writers. I know a
>>> few
>>> > > > > projects
>>> > > > > > > have
>>> > > > > > > >>> used various tools for documentation - but not sure
>>> about any
>>> > > > > > technical
>>> > > > > > > >>> writing collaboration (so if you know of any then please
>>> let
>>> > me
>>> > > > > know)
>>> > > > > > > >>>
>>> > > > > > > >>> 5. Application Form: GSoC
>>> > > > > > > >>> There is a section to complete at our participation in
>>> GSoC.I
>>> > > > > think I
>>> > > > > > > >> have
>>> > > > > > > >>> the details from our application this year so can follow
>>> up
>>> > > with
>>> > > > > > Maxim
>>> > > > > > > or
>>> > > > > > > >>> Uli about it
>>> > > > > > > >>>
>>> > > > > > > >>> This is all I have at the moment and we have until the
>>> 23rd
>>> > > April
>>> > > > > > 2019
>>> > > > > > > to
>>> > > > > > > >>> finalise all the application details. Ideally I want to
>>> have
>>> > it
>>> > > > > done
>>> > > > > > > well
>>> > > > > > > >>> before then :-)
>>> > > > > > > >>>
>>> > > > > > > >>> Please pass on this information within your various
>>> projects
>>> > > and
>>> > > > as
>>> > > > > > > with
>>> > > > > > > >>> GSoC - I'll see how we can get this information out to
>>> all
>>> > our
>>> > > > > > project
>>> > > > > > > >>> mailing lists.
>>> > > > > > > >>>
>>> > > > > > > >>> Thanks
>>> > > > > > > >>> Sharan
>>> > > > > > > >>>
>>> > > > > > > >>> ==================================================
>>> > > > > > > >>>
>>> > > > > > > >>> I guess, we would need to follow these steps as well.
>>> > > > > > > >>>
>>> > > > > > > >>> Best,
>>> > > > > > > >>> Fabian
>>> > > > > > > >>>
>>> > > > > > > >>> Am Do., 11. Apr. 2019 um 05:08 Uhr schrieb Jark Wu <
>>> > > > > [hidden email]
>>> > > > > > >:
>>> > > > > > > >>>
>>> > > > > > > >>>> Hi Aizhamal,
>>> > > > > > > >>>>
>>> > > > > > > >>>> That's really interesting. We have an ongoing proposal
>>> for
>>> > > > > > supporting
>>> > > > > > > >>>> Chinese documentation, see FLIP-35 [1].
>>> > > > > > > >>>>
>>> > > > > > > >>>> I think it's a good idea to propose Chinese translation
>>> as a
>>> > > > > > project.
>>> > > > > > > >>> It's
>>> > > > > > > >>>> a good chance to improve the localization user
>>> experience of
>>> > > > Flink
>>> > > > > > > >>>> documentation.
>>> > > > > > > >>>> I can help as a mentor if we want to submit such a
>>> project.
>>> > > > > > > >>>>
>>> > > > > > > >>>> Thanks,
>>> > > > > > > >>>> Jark Wu
>>> > > > > > > >>>>
>>> > > > > > > >>>> [1]:
>>> > > > > > > >>>>
>>> > > > > > > >>>
>>> > > > > > > >>
>>> > > > > > >
>>> > > > > >
>>> > > > >
>>> > > >
>>> > >
>>> >
>>> https://cwiki.apache.org/confluence/display/FLINK/FLIP-35%3A+Support+Chinese+Documents+and+Website
>>> > > > > > > >>>>
>>> > > > > > > >>>> On Thu, 11 Apr 2019 at 02:11, Aizhamal Nurmamat kyzy
>>> > > > > > > >>>> <[hidden email]> wrote:
>>> > > > > > > >>>>
>>> > > > > > > >>>>> Hello everyone,
>>> > > > > > > >>>>>
>>> > > > > > > >>>>> @Fabian Hueske <[hidden email]> - SoD setup is a
>>> little
>>> > > bit
>>> > > > > > > >>> different.
>>> > > > > > > >>>>> The ASF determined that each project would be allowed
>>> to
>>> > > apply
>>> > > > > > > >>>>> individually[1], rather than applying as a single large
>>> > > > > > organization.
>>> > > > > > > >>>>>
>>> > > > > > > >>>>> Each project applies as an org, with two organizers
>>> > > > (administers)
>>> > > > > > and
>>> > > > > > > >> at
>>> > > > > > > >>>>> least two mentors. As Konstantin pointed out, one can
>>> be
>>> > both
>>> > > > an
>>> > > > > > > >>>>> administer
>>> > > > > > > >>>>> and a mentor. You don't need to coordinate with other
>>> > > projects
>>> > > > or
>>> > > > > > ASF
>>> > > > > > > >> at
>>> > > > > > > >>>>> all. If accepted to the program, you will receive
>>> project
>>> > > > > proposals
>>> > > > > > > >> from
>>> > > > > > > >>>>> tech writers [2]. You will choose one or two proposals
>>> that
>>> > > you
>>> > > > > > want
>>> > > > > > > >> to
>>> > > > > > > >>>>> mentor[3].
>>> > > > > > > >>>>>
>>> > > > > > > >>>>> @Ken - as for the language, there isn’t any
>>> limitations in
>>> > > that
>>> > > > > > > >> regard,
>>> > > > > > > >>> so
>>> > > > > > > >>>>> work on the Chinese translation for the website is
>>> > definitely
>>> > > > an
>>> > > > > > > >>>>> acceptable
>>> > > > > > > >>>>> project.
>>> > > > > > > >>>>>
>>> > > > > > > >>>>> Thanks,
>>> > > > > > > >>>>>
>>> > > > > > > >>>>> Aizhamal
>>> > > > > > > >>>>>
>>> > > > > > > >>>>>
>>> > > > > > > >>>>> [1]
>>> > > > > > > >>>>>
>>> > > > > > > >>>>>
>>> > > > > > > >>>
>>> > > > > > > >>
>>> > > > > > >
>>> > > > > >
>>> > > > >
>>> > > >
>>> > >
>>> >
>>> https://lists.apache.org/thread.html/67e1c2e6041cff1e7f198b615407401f032795130e796adfaacf8071@%3Cdev.community.apache.org%3E
>>> > > > > > > >>>>>
>>> > > > > > > >>>>> [2] https://developers.google.com/season-of-docs/docs/
>>> > > > > > > >>>>>
>>> > > > > > > >>>>> [3]
>>> > > > > > > >>>
>>> > > > > >
>>> > >
>>> https://developers.google.com/season-of-docs/docs/faq#slot-allocation
>>> > > > > > > >>>>>
>>> > > > > > > >>>>>
>>> > > > > > > >>>>> On Wed, Apr 10, 2019 at 8:32 AM Ken Krugler <
>>> > > > > > > >>> [hidden email]>
>>> > > > > > > >>>>> wrote:
>>> > > > > > > >>>>>
>>> > > > > > > >>>>>> Hi Aizhamal,
>>> > > > > > > >>>>>>
>>> > > > > > > >>>>>> I assume SoD is language-agnostic, so one possible
>>> project
>>> > > > would
>>> > > > > > be
>>> > > > > > > >> to
>>> > > > > > > >>>>> get
>>> > > > > > > >>>>>> a tech writer for the Chinese versions of all of the
>>> Flink
>>> > > > > > > >>>>> documentation,
>>> > > > > > > >>>>>> yes?
>>> > > > > > > >>>>>>
>>> > > > > > > >>>>>> Regards,
>>> > > > > > > >>>>>>
>>> > > > > > > >>>>>> — Ken
>>> > > > > > > >>>>>>
>>> > > > > > > >>>>>>> On Apr 5, 2019, at 3:43 PM, Aizhamal Nurmamat kyzy
>>> > > > > > > >>>>>> <[hidden email]> wrote:
>>> > > > > > > >>>>>>>
>>> > > > > > > >>>>>>> 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
>>> > > > > > >
>>> > > > > > > --------------------------
>>> > > > > > > Ken Krugler
>>> > > > > > > [phone]
>>> > > > > > > http://www.scaleunlimited.com
>>> > > > > > > Custom big data solutions & training
>>> > > > > > > Flink, Solr, Hadoop, Cascading & Cassandra
>>> > > > > > >
>>> > > > > > >
>>> > > > > >
>>> > > > >
>>> > > >
>>> > >
>>> >
>>>
>>
>>
>> --
>>
>> Konstantin Knauf | Solutions Architect
>>
>> [phone]
>>
>> <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
>>
>

--

Konstantin Knauf | Solutions Architect

[phone]

<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

[Robert Metzger]

Hi all,
I'm very happy to see this project happening!

Thank you for the proposal Konstantin! One idea for the "related material":
we could also link to talks or blog posts about concepts / monitoring /
operations. Potential writers could feel overwhelmed by our demand for
improvements, without any additional material.


On Mon, Apr 15, 2019 at 10:16 AM Konstantin Knauf <[hidden email]>
wrote:

> Hi everyone,
>
> thanks @Aizhamal Nurmamat kyzy <[hidden email]>. As we only have one
> week left until the application deadline, I went ahead and created a
> document for the project ideas [1]. I have added the description for the
> "stream processing concepts" as well as the "deployment & operations
> documentation" project idea. Please let me know what you think, edit &
> comment. We also need descriptions for the other two projects (Table
> API/SQL & Flink Internals). @Fabian/@Jark/@Stephan can you chime in?
>
> Any more project ideas?
>
> Best,
>
> Konstantin
>
>
> [1]
>
> https://docs.google.com/document/d/1Up53jNsLztApn-mP76AB6xWUVGt3nwS9p6xQTiceKXo/edit?usp=sharing
>
>
>
> On Fri, Apr 12, 2019 at 6:50 PM Aizhamal Nurmamat kyzy <
> [hidden email]>
> wrote:
>
> > Hello everyone,
> >
> > @Konstantin Knauf <[hidden email]> - yes, you are correct.
> > Between steps 1 and 2 though, the open source organization, in this case
> > Flink, has to be selected by SoD as one of the participating orgs
> *fingers
> > crossed*.
> >
> > One tip about organizing ideas is that you want to communicate potential
> > projects to the tech writers that are applying. Just make sure the scope
> of
> > the project is clear to them. The SoD wants to set up the tech writers
> for
> > success by making sure the work can be done in the allotted time.
> >
> > Hope it helps.
> >
> > Aizhamal
> >
> >
> >
> > On Fri, Apr 12, 2019 at 7:37 AM Konstantin Knauf <
> [hidden email]>
> > wrote:
> >
> >> Hi all,
> >>
> >> I read through the SoD documentation again, and now I think, it would
> >> actually make sense to split (1) up into multiple project ideas. Let me
> >> summarize the overall process:
> >>
> >> 1. We create & publish a list of project ideas, e.g. in a blog post.
> >> (This can be any number of ideas.)
> >> 2. Potential technical writers look at our list of ideas and sent a
> >> proposal for a particular project to Google. During that time they can
> >> reach out to us for clarification.
> >> 3. Google forwards all proposals for our project ideas to us and we sent
> >> back a prioritized list of proposals, which we would like to accept.
> >> 4. Of all these proposals, Google accepts 50 proposals for SoD 2019. Per
> >> organization Google will only accept a maximum of two proposals.
> >>
> >> @Aizhamal Nurmamat kyzy <[hidden email]> Please correct me!
> >>
> >> For me this means we should splits this up in a way, that each project
> is
> >> a) still relevant in September b) makes sense as a 3 month project.
> Based
> >> on the ideas we have right now these could for example be:
> >>
> >> (I) Rework/Extract/Improve the documentation of stream processing
> concepts
> >> (II) Improve & extend Apache Flink's documentation for deployment,
> >> operations (incl. configuration)
> >> (III) Add documentation for Flink internals
> >> (IV) Rework Table API / SQL documentation
> >>
> >> We would then get proposals potentially for all of these topics and
> could
> >> decide which of these proposals, we would sent back to Google. My
> feeling
> >> is that a technical writer could easily spent three months on any of
> these
> >> projects. What do others think? Any other project ideas?
> >>
> >> Cheers,
> >>
> >> Konstantin
> >>
> >>
> >>
> >>
> >> On Fri, Apr 12, 2019 at 1:47 PM Jark Wu <[hidden email]> wrote:
> >>
> >>> Hi all,
> >>>
> >>> I'm fine with only preparing the first proposal. I think it's
> reasonable
> >>> because the first proposal is more attractive
> >>> and maybe there is not enough Chinese writer. We can focus on one
> project
> >>> to come up with a concrete and
> >>> attractive project plan.
> >>>
> >>> One possible subproject could be rework Table SQL docs.
> >>> (1). Improve concepts in Table SQL.
> >>> (2). A more detailed introduction of built-in functions, currently we
> >>> only
> >>> have a simple explanation for each function.
> >>>       We should add more descriptions, especially more concrete
> examples,
> >>> and maybe some notes. We can take
> >>>       MySQL doc [1] as a reference.
> >>> (3). As Flink SQL is evolving rapidly and features from Blink is being
> >>> merged,  for example, SQL DDL, Hive integration,
> >>>       Python Table API, Interactive Programing, SQL optimization and
> >>> tuning, etc... We can redesign the doc structure of
> >>>       Table SQL in a higher vision.
> >>>
> >>> Cheers,
> >>> Jark
> >>>
> >>> [1]:
> >>>
> >>>
> https://dev.mysql.com/doc/refman/5.7/en/string-functions.html#function_bin
> >>>
> >>>
> >>>
> >>> On Fri, 12 Apr 2019 at 18:19, jincheng sun <[hidden email]>
> >>> wrote:
> >>>
> >>> > I am honored to have the opportunity to do a second organization
> >>> > administrator‘s works!
> >>> >
> >>> > It seems that one project and multiple projects have their own
> >>> advantages.
> >>> >
> >>> > My understanding is that even if we only have one project, we also
> can
> >>> have
> >>> > multiple mentors and recruit enough writers.
> >>> >
> >>> > Fabian Hueske <[hidden email]> 于2019年4月12日周五 下午5:57写道：
> >>> >
> >>> > > Yes, I think we would get at most one project accepted.
> >>> > > Having all options in a rather generic proposal gives us the most
> >>> > > flexibility to decide what to work on once the proposal is
> accepted.
> >>> > > On the other hand, a more concrete proposal might look more
> >>> attractive
> >>> > for
> >>> > > candidates.
> >>> > > I'm fine either way, but my gut feeling is that a well scoped
> >>> proposal
> >>> > > gives better changes of finding a writer (which might be the
> biggest
> >>> > > challenge).
> >>> > >
> >>> > > Am Fr., 12. Apr. 2019 um 11:39 Uhr schrieb Stephan Ewen <
> >>> > [hidden email]
> >>> > > >:
> >>> > >
> >>> > > > I would suggest to make one proposal and have the subsections
> only
> >>> in
> >>> > the
> >>> > > > project plan.
> >>> > > > My understanding is that we need to indicate priorities between
> >>> > proposals
> >>> > > > and might get only one, so it would be good to not subdivide.
> >>> > > >
> >>> > > > On Fri, Apr 12, 2019 at 9:58 AM Fabian Hueske <[hidden email]
> >
> >>> > wrote:
> >>> > > >
> >>> > > > > Hi everyone,
> >>> > > > >
> >>> > > > > I think we can split the first project that Stephan proposed
> into
> >>> > > smaller
> >>> > > > > ones:
> >>> > > > >
> >>> > > > > > (1) Create or rework setup / tutorials / concepts docs
> >>> > > > > > (2) Complete (or advance) the Chinese translation
> >>> > > > >
> >>> > > > > 1.1 Improving (extracting) the documentation of stream
> processing
> >>> > > > concepts:
> >>> > > > > Event-time, Timers, State, State Backends, Checkpointing,
> >>> Savepoints
> >>> > > > > Right now, the relevant information is scattered across several
> >>> pages
> >>> > > and
> >>> > > > > mixed with the implementation / APIs / configuration options.
> >>> > > > >
> >>> > > > > 1.2 Improving & extending the documentation of deployments
> >>> > > > >
> >>> > > > > 1.3 Adding documentation in the internals: Distributed
> >>> architecture,
> >>> > > > > recovery, operators, job translation, execution, etc.
> >>> > > > > This documentation would be targeted to Flink developers.
> >>> > > > >
> >>> > > > > I thought again about the idea of improving the tutorials, and
> >>> I'm no
> >>> > > > > longer sure if this would fit SoD well.
> >>> > > > > The reason is that creating good tutorials requires a good
> >>> portion of
> >>> > > > > coding / configuration (creating Docker images, example
> programs,
> >>> > > etc.).
> >>> > > > > Also I'd like to start improving the situation of tutorials
> >>> earlier
> >>> > > than
> >>> > > > > September.
> >>> > > > >
> >>> > > > > What do others think?
> >>> > > > >
> >>> > > > > Cheers, Fabian
> >>> > > > >
> >>> > > > >
> >>> > > > > Am Fr., 12. Apr. 2019 um 04:29 Uhr schrieb Jark Wu <
> >>> [hidden email]
> >>> > >:
> >>> > > > >
> >>> > > > > > Hi Konstantin, Ken,
> >>> > > > > >
> >>> > > > > > I agree that Chinese documentation is mainly a translation.
> >>> > > > > >
> >>> > > > > > >  Does anyone from the Blink team have input on whether
> there
> >>> is
> >>> > > > > existing,
> >>> > > > > > original Chinese documentation which should be translated to
> >>> > English?
> >>> > > > > >
> >>> > > > > > There is a public Blink documentation [1] which is English.
> >>> > > > > > We have a Blink Chinese documentation in internal, but I
> think
> >>> we
> >>> > > need
> >>> > > > to
> >>> > > > > > rewrite it in English and restructure it when contributing
> >>> Blink to
> >>> > > > > Flink.
> >>> > > > > >
> >>> > > > > > Regarding the Chinese translation project, I agree with Ken's
> >>> > > opinion.
> >>> > > > > >
> >>> > > > > > From the point of my translation experience, translation is a
> >>> work
> >>> > > that
> >>> > > > > > need to understand the original English sentence correctly
> and
> >>> then
> >>> > > > > express
> >>> > > > > > it in Chinese in an easily understandable way. This is not a
> >>> simple
> >>> > > > work
> >>> > > > > > that translate word by word. The one we need is not a
> >>> "professional
> >>> > > > > > translator",
> >>> > > > > > but a "technical writer who are familiar with both
> >>> languages".  I
> >>> > > also
> >>> > > > > > agree that the writer who write the initial documentation has
> >>> the
> >>> > > > better
> >>> > > > > > ability than
> >>> > > > > > translator to distill complex technical concepts.
> >>> > > > > >
> >>> > > > > > [1]: https://flink-china.org/doc/blink
> >>> > > > > >
> >>> > > > > > On Fri, 12 Apr 2019 at 02:40, Ken Krugler <
> >>> > > [hidden email]
> >>> > > > >
> >>> > > > > > wrote:
> >>> > > > > >
> >>> > > > > > > Hi Konstantin,
> >>> > > > > > >
> >>> > > > > > > Comments inline below…
> >>> > > > > > >
> >>> > > > > > > — Ken
> >>> > > > > > >
> >>> > > > > > > > On Apr 11, 2019, at 9:05 AM, Konstantin Knauf <
> >>> > > > > > [hidden email]>
> >>> > > > > > > wrote:
> >>> > > > > > > >
> >>> > > > > > > > Hi everyone,
> >>> > > > > > > >
> >>> > > > > > > > I will start going through the registration process
> >>> tomorrow
> >>> > > (CET).
> >>> > > > > > > > Jincheng (cc) reached out to me directly and offered to
> be
> >>> the
> >>> > > > second
> >>> > > > > > > > organization administrator. So, we are all set in that
> >>> regard.
> >>> > > > > > > >
> >>> > > > > > > > In terms of mentors, we now have
> >>> > > > > > > >
> >>> > > > > > > > * myself
> >>> > > > > > > > * Fabian
> >>> > > > > > > > * David
> >>> > > > > > > > * Stephan
> >>> > > > > > > > * Jark (Chinese Translation)
> >>> > > > > > > >
> >>> > > > > > > > Regarding the Chinese translation project, it is
> probably a
> >>> > > > question
> >>> > > > > of
> >>> > > > > > > how
> >>> > > > > > > > independent the Chinese version is supposed to be. If the
> >>> > English
> >>> > > > > > > > documentation is the ground-truth and the Chinese
> >>> documentation
> >>> > > is
> >>> > > > > > > (mainly)
> >>> > > > > > > > a translation, I agree with Stefan. If the Chinese
> >>> > documentation
> >>> > > is
> >>> > > > > > > > supposed to become an independent secondary
> documentation,
> >>> it
> >>> > > could
> >>> > > > > be
> >>> > > > > > a
> >>> > > > > > > > project for a technical writer as well. Has this
> questions
> >>> > > already
> >>> > > > > been
> >>> > > > > > > > discussed in the community?
> >>> > > > > > >
> >>> > > > > > > My understanding is that the Chinese documentation is going
> >>> to
> >>> > > mostly
> >>> > > > > be
> >>> > > > > > a
> >>> > > > > > > translation of the English versions.
> >>> > > > > > >
> >>> > > > > > > Though perhaps, with all of the Blink integration going on,
> >>> the
> >>> > > > inverse
> >>> > > > > > > could also be true.
> >>> > > > > > >
> >>> > > > > > > Does anyone from the Blink team have input on whether there
> >>> is
> >>> > > > > existing,
> >>> > > > > > > original Chinese documentation which should be translated
> to
> >>> > > English?
> >>> > > > > > >
> >>> > > > > > > > On Thu, Apr 11, 2019 at 11:34 AM Stephan Ewen <
> >>> > [hidden email]>
> >>> > > > > > wrote:
> >>> > > > > > > >
> >>> > > > > > > >> So we have two ideas for docs projects now:
> >>> > > > > > > >>
> >>> > > > > > > >> (1) Create or rework setup / tutorials / concepts docs
> >>> > > > > > > >> (2) Complete (or advance) the Chinese translation
> >>> > > > > > > >>
> >>> > > > > > > >> Should we apply for both (and let the SoD committee
> select
> >>> > > > whichever
> >>> > > > > > > they
> >>> > > > > > > >> want to sponsor) or select one of them?
> >>> > > > > > > >>
> >>> > > > > > > >> For project (2), this sounds to me more like a project
> >>> for a
> >>> > > > > > > "translator",
> >>> > > > > > > >> not a "technical writer". As far as I understand it, the
> >>> big
> >>> > > > benefit
> >>> > > > > > of
> >>> > > > > > > >> having a technical writer is to have someone who can
> >>> describe
> >>> > > > > > > complicated
> >>> > > > > > > >> technical concepts (that engineers describe in
> complicated
> >>> > > > language)
> >>> > > > > > in
> >>> > > > > > > an
> >>> > > > > > > >> easily understandable way.
> >>> > > > > > >
> >>> > > > > > > Actually a good Chinese translation of the technical docs
> >>> > requires
> >>> > > > > > someone
> >>> > > > > > > with many of the same skills. In order for the translation
> >>> to be
> >>> > > > > > accurate,
> >>> > > > > > > you need someone who understands the concepts of the
> >>> underlying
> >>> > > > > > technology,
> >>> > > > > > > to use appropriate terminology. Though I agree that the
> >>> ability
> >>> > to
> >>> > > > > > distill
> >>> > > > > > > complex technical concepts is more important when writing
> >>> initial
> >>> > > > > > > documentation.
> >>> > > > > > >
> >>> > > > > > >
> >>> > > > > > > >> On Thu, Apr 11, 2019 at 9:47 AM Fabian Hueske <
> >>> > > [hidden email]>
> >>> > > > > > > wrote:
> >>> > > > > > > >>
> >>> > > > > > > >>> Thanks for the clarification Aizhamal!
> >>> > > > > > > >>> This is really helpful and will make it a lot easier to
> >>> > > > coordinate
> >>> > > > > > :-)
> >>> > > > > > > >>>
> >>> > > > > > > >>> As for next steps, I found this email on the
> >>> > > > > > [hidden email]
> >>> > > > > > > >>> mailing list:
> >>> > > > > > > >>>
> >>> > > > > > > >>> ==================================================
> >>> > > > > > > >>> Hi All,
> >>> > > > > > > >>>
> >>> > > > > > > >>> As mentioned the applications for the Google Season of
> >>> Docs
> >>> > > > opened
> >>> > > > > > > today
> >>> > > > > > > >>> and I'm working my way through it on behalf of the ASF.
> >>> > > > > > > >>>
> >>> > > > > > > >>> If accepted, we will be allocated either one or two
> >>> techical
> >>> > > > > writers.
> >>> > > > > > > >>> Google will also pay the ASF a stipend of $500 per
> >>> technical
> >>> > > > writer
> >>> > > > > > > >>> mentored (which I hope can go directly to fundraising
> :-)
> >>> > > > > > > >>>
> >>> > > > > > > >>> Each project that wants to participate must provide two
> >>> > mentors
> >>> > > > for
> >>> > > > > > > each
> >>> > > > > > > >>> documentation project.
> >>> > > > > > > >>>
> >>> > > > > > > >>> As part of the application process there are a few
> things
> >>> > that
> >>> > > we
> >>> > > > > > need
> >>> > > > > > > to
> >>> > > > > > > >>> setup.
> >>> > > > > > > >>>
> >>> > > > > > > >>> 1. Season of Docs Page and List of Project Ideas
> >>> > > > > > > >>> We need to create a public webpage about Season of Docs
> >>> that
> >>> > > > > contains
> >>> > > > > > > the
> >>> > > > > > > >>> list of project ideas for documentation. I have
> created a
> >>> > page
> >>> > > on
> >>> > > > > the
> >>> > > > > > > >>> ComDev wiki https://s.apache.org/w4CH  with a table
> for
> >>> > > projects
> >>> > > > > to
> >>> > > > > > > >> record
> >>> > > > > > > >>> their ideas.
> >>> > > > > > > >>>
> >>> > > > > > > >>> 2. Alternative administrator.
> >>> > > > > > > >>> I’ve set myself up as the primary admin and Maxim as
> the
> >>> > > > > alternative
> >>> > > > > > > >> admin
> >>> > > > > > > >>> (Maxim, I need to confirm your contact email and you
> will
> >>> > also
> >>> > > > need
> >>> > > > > > to
> >>> > > > > > > >>> register as the alternative admin and I will email you
> >>> the
> >>> > link
> >>> > > > > > > offline)
> >>> > > > > > > >>>
> >>> > > > > > > >>> 3. Mentors
> >>> > > > > > > >>> All mentors from the projects interested in
> participating
> >>> > must
> >>> > > > > > register
> >>> > > > > > > >>> individually at the following link :
> >>> > > > > > > https://forms.gle/a1x26WQGzURLerv66
> >>> > > > > > > >> .
> >>> > > > > > > >>>
> >>> > > > > > > >>> 4. Application Form: Documentation / Technnial Writer
> >>> > > > Collaboration
> >>> > > > > > > >>> There is a section to fill in about experience with
> >>> > > documentation
> >>> > > > > and
> >>> > > > > > > any
> >>> > > > > > > >>> previous collaboration with technical writers. I know a
> >>> few
> >>> > > > > projects
> >>> > > > > > > have
> >>> > > > > > > >>> used various tools for documentation - but not sure
> >>> about any
> >>> > > > > > technical
> >>> > > > > > > >>> writing collaboration (so if you know of any then
> please
> >>> let
> >>> > me
> >>> > > > > know)
> >>> > > > > > > >>>
> >>> > > > > > > >>> 5. Application Form: GSoC
> >>> > > > > > > >>> There is a section to complete at our participation in
> >>> GSoC.I
> >>> > > > > think I
> >>> > > > > > > >> have
> >>> > > > > > > >>> the details from our application this year so can
> follow
> >>> up
> >>> > > with
> >>> > > > > > Maxim
> >>> > > > > > > or
> >>> > > > > > > >>> Uli about it
> >>> > > > > > > >>>
> >>> > > > > > > >>> This is all I have at the moment and we have until the
> >>> 23rd
> >>> > > April
> >>> > > > > > 2019
> >>> > > > > > > to
> >>> > > > > > > >>> finalise all the application details. Ideally I want to
> >>> have
> >>> > it
> >>> > > > > done
> >>> > > > > > > well
> >>> > > > > > > >>> before then :-)
> >>> > > > > > > >>>
> >>> > > > > > > >>> Please pass on this information within your various
> >>> projects
> >>> > > and
> >>> > > > as
> >>> > > > > > > with
> >>> > > > > > > >>> GSoC - I'll see how we can get this information out to
> >>> all
> >>> > our
> >>> > > > > > project
> >>> > > > > > > >>> mailing lists.
> >>> > > > > > > >>>
> >>> > > > > > > >>> Thanks
> >>> > > > > > > >>> Sharan
> >>> > > > > > > >>>
> >>> > > > > > > >>> ==================================================
> >>> > > > > > > >>>
> >>> > > > > > > >>> I guess, we would need to follow these steps as well.
> >>> > > > > > > >>>
> >>> > > > > > > >>> Best,
> >>> > > > > > > >>> Fabian
> >>> > > > > > > >>>
> >>> > > > > > > >>> Am Do., 11. Apr. 2019 um 05:08 Uhr schrieb Jark Wu <
> >>> > > > > [hidden email]
> >>> > > > > > >:
> >>> > > > > > > >>>
> >>> > > > > > > >>>> Hi Aizhamal,
> >>> > > > > > > >>>>
> >>> > > > > > > >>>> That's really interesting. We have an ongoing proposal
> >>> for
> >>> > > > > > supporting
> >>> > > > > > > >>>> Chinese documentation, see FLIP-35 [1].
> >>> > > > > > > >>>>
> >>> > > > > > > >>>> I think it's a good idea to propose Chinese
> translation
> >>> as a
> >>> > > > > > project.
> >>> > > > > > > >>> It's
> >>> > > > > > > >>>> a good chance to improve the localization user
> >>> experience of
> >>> > > > Flink
> >>> > > > > > > >>>> documentation.
> >>> > > > > > > >>>> I can help as a mentor if we want to submit such a
> >>> project.
> >>> > > > > > > >>>>
> >>> > > > > > > >>>> Thanks,
> >>> > > > > > > >>>> Jark Wu
> >>> > > > > > > >>>>
> >>> > > > > > > >>>> [1]:
> >>> > > > > > > >>>>
> >>> > > > > > > >>>
> >>> > > > > > > >>
> >>> > > > > > >
> >>> > > > > >
> >>> > > > >
> >>> > > >
> >>> > >
> >>> >
> >>>
> https://cwiki.apache.org/confluence/display/FLINK/FLIP-35%3A+Support+Chinese+Documents+and+Website
> >>> > > > > > > >>>>
> >>> > > > > > > >>>> On Thu, 11 Apr 2019 at 02:11, Aizhamal Nurmamat kyzy
> >>> > > > > > > >>>> <[hidden email]> wrote:
> >>> > > > > > > >>>>
> >>> > > > > > > >>>>> Hello everyone,
> >>> > > > > > > >>>>>
> >>> > > > > > > >>>>> @Fabian Hueske <[hidden email]> - SoD setup is a
> >>> little
> >>> > > bit
> >>> > > > > > > >>> different.
> >>> > > > > > > >>>>> The ASF determined that each project would be allowed
> >>> to
> >>> > > apply
> >>> > > > > > > >>>>> individually[1], rather than applying as a single
> large
> >>> > > > > > organization.
> >>> > > > > > > >>>>>
> >>> > > > > > > >>>>> Each project applies as an org, with two organizers
> >>> > > > (administers)
> >>> > > > > > and
> >>> > > > > > > >> at
> >>> > > > > > > >>>>> least two mentors. As Konstantin pointed out, one can
> >>> be
> >>> > both
> >>> > > > an
> >>> > > > > > > >>>>> administer
> >>> > > > > > > >>>>> and a mentor. You don't need to coordinate with other
> >>> > > projects
> >>> > > > or
> >>> > > > > > ASF
> >>> > > > > > > >> at
> >>> > > > > > > >>>>> all. If accepted to the program, you will receive
> >>> project
> >>> > > > > proposals
> >>> > > > > > > >> from
> >>> > > > > > > >>>>> tech writers [2]. You will choose one or two
> proposals
> >>> that
> >>> > > you
> >>> > > > > > want
> >>> > > > > > > >> to
> >>> > > > > > > >>>>> mentor[3].
> >>> > > > > > > >>>>>
> >>> > > > > > > >>>>> @Ken - as for the language, there isn’t any
> >>> limitations in
> >>> > > that
> >>> > > > > > > >> regard,
> >>> > > > > > > >>> so
> >>> > > > > > > >>>>> work on the Chinese translation for the website is
> >>> > definitely
> >>> > > > an
> >>> > > > > > > >>>>> acceptable
> >>> > > > > > > >>>>> project.
> >>> > > > > > > >>>>>
> >>> > > > > > > >>>>> Thanks,
> >>> > > > > > > >>>>>
> >>> > > > > > > >>>>> Aizhamal
> >>> > > > > > > >>>>>
> >>> > > > > > > >>>>>
> >>> > > > > > > >>>>> [1]
> >>> > > > > > > >>>>>
> >>> > > > > > > >>>>>
> >>> > > > > > > >>>
> >>> > > > > > > >>
> >>> > > > > > >
> >>> > > > > >
> >>> > > > >
> >>> > > >
> >>> > >
> >>> >
> >>>
> https://lists.apache.org/thread.html/67e1c2e6041cff1e7f198b615407401f032795130e796adfaacf8071@%3Cdev.community.apache.org%3E
> >>> > > > > > > >>>>>
> >>> > > > > > > >>>>> [2]
> https://developers.google.com/season-of-docs/docs/
> >>> > > > > > > >>>>>
> >>> > > > > > > >>>>> [3]
> >>> > > > > > > >>>
> >>> > > > > >
> >>> > >
> >>> https://developers.google.com/season-of-docs/docs/faq#slot-allocation
> >>> > > > > > > >>>>>
> >>> > > > > > > >>>>>
> >>> > > > > > > >>>>> On Wed, Apr 10, 2019 at 8:32 AM Ken Krugler <
> >>> > > > > > > >>> [hidden email]>
> >>> > > > > > > >>>>> wrote:
> >>> > > > > > > >>>>>
> >>> > > > > > > >>>>>> Hi Aizhamal,
> >>> > > > > > > >>>>>>
> >>> > > > > > > >>>>>> I assume SoD is language-agnostic, so one possible
> >>> project
> >>> > > > would
> >>> > > > > > be
> >>> > > > > > > >> to
> >>> > > > > > > >>>>> get
> >>> > > > > > > >>>>>> a tech writer for the Chinese versions of all of the
> >>> Flink
> >>> > > > > > > >>>>> documentation,
> >>> > > > > > > >>>>>> yes?
> >>> > > > > > > >>>>>>
> >>> > > > > > > >>>>>> Regards,
> >>> > > > > > > >>>>>>
> >>> > > > > > > >>>>>> — Ken
> >>> > > > > > > >>>>>>
> >>> > > > > > > >>>>>>> On Apr 5, 2019, at 3:43 PM, Aizhamal Nurmamat kyzy
> >>> > > > > > > >>>>>> <[hidden email]> wrote:
> >>> > > > > > > >>>>>>>
> >>> > > > > > > >>>>>>> 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
> >>> > > > > > >
> >>> > > > > > > --------------------------
> >>> > > > > > > Ken Krugler
> >>> > > > > > > [phone]
> >>> > > > > > > http://www.scaleunlimited.com
> >>> > > > > > > Custom big data solutions & training
> >>> > > > > > > Flink, Solr, Hadoop, Cascading & Cassandra
> >>> > > > > > >
> >>> > > > > > >
> >>> > > > > >
> >>> > > > >
> >>> > > >
> >>> > >
> >>> >
> >>>
> >>
> >>
> >> --
> >>
> >> Konstantin Knauf | Solutions Architect
> >>
> >> [phone]
> >>
> >> <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
> >>
> >
>
> --
>
> Konstantin Knauf | Solutions Architect
>
> [phone]
>
> <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
>

[Aizhamal Nurmamat kyzy]

+Konstantin Knauf <[hidden email]> this is looking good, thanks
for sharing!

I also created a similar doc for Apache Airflow [1]. It is a bit messy, but
it has questions from the application form that you can work with.

Cheers,
Aizhamal

[1]
https://docs.google.com/document/d/1HoL_yjNYiTAP9IxSlhx3EUnPFU4l9WOT9EnwBZjCZo0/edit#


On Mon, Apr 15, 2019 at 2:24 AM Robert Metzger <[hidden email]> wrote:

> Hi all,
> I'm very happy to see this project happening!
>
> Thank you for the proposal Konstantin! One idea for the "related
> material": we could also link to talks or blog posts about concepts /
> monitoring / operations. Potential writers could feel overwhelmed by our
> demand for improvements, without any additional material.
>
>
> On Mon, Apr 15, 2019 at 10:16 AM Konstantin Knauf <
> [hidden email]> wrote:
>
>> Hi everyone,
>>
>> thanks @Aizhamal Nurmamat kyzy <[hidden email]>. As we only have one
>> week left until the application deadline, I went ahead and created a
>> document for the project ideas [1]. I have added the description for the
>> "stream processing concepts" as well as the "deployment & operations
>> documentation" project idea. Please let me know what you think, edit &
>> comment. We also need descriptions for the other two projects (Table
>> API/SQL & Flink Internals). @Fabian/@Jark/@Stephan can you chime in?
>>
>> Any more project ideas?
>>
>> Best,
>>
>> Konstantin
>>
>>
>> [1]
>>
>> https://docs.google.com/document/d/1Up53jNsLztApn-mP76AB6xWUVGt3nwS9p6xQTiceKXo/edit?usp=sharing
>>
>>
>>
>> On Fri, Apr 12, 2019 at 6:50 PM Aizhamal Nurmamat kyzy <
>> [hidden email]>
>> wrote:
>>
>> > Hello everyone,
>> >
>> > @Konstantin Knauf <[hidden email]> - yes, you are correct.
>> > Between steps 1 and 2 though, the open source organization, in this case
>> > Flink, has to be selected by SoD as one of the participating orgs
>> *fingers
>> > crossed*.
>> >
>> > One tip about organizing ideas is that you want to communicate potential
>> > projects to the tech writers that are applying. Just make sure the
>> scope of
>> > the project is clear to them. The SoD wants to set up the tech writers
>> for
>> > success by making sure the work can be done in the allotted time.
>> >
>> > Hope it helps.
>> >
>> > Aizhamal
>> >
>> >
>> >
>> > On Fri, Apr 12, 2019 at 7:37 AM Konstantin Knauf <
>> [hidden email]>
>> > wrote:
>> >
>> >> Hi all,
>> >>
>> >> I read through the SoD documentation again, and now I think, it would
>> >> actually make sense to split (1) up into multiple project ideas. Let me
>> >> summarize the overall process:
>> >>
>> >> 1. We create & publish a list of project ideas, e.g. in a blog post.
>> >> (This can be any number of ideas.)
>> >> 2. Potential technical writers look at our list of ideas and sent a
>> >> proposal for a particular project to Google. During that time they can
>> >> reach out to us for clarification.
>> >> 3. Google forwards all proposals for our project ideas to us and we
>> sent
>> >> back a prioritized list of proposals, which we would like to accept.
>> >> 4. Of all these proposals, Google accepts 50 proposals for SoD 2019.
>> Per
>> >> organization Google will only accept a maximum of two proposals.
>> >>
>> >> @Aizhamal Nurmamat kyzy <[hidden email]> Please correct me!
>> >>
>> >> For me this means we should splits this up in a way, that each project
>> is
>> >> a) still relevant in September b) makes sense as a 3 month project.
>> Based
>> >> on the ideas we have right now these could for example be:
>> >>
>> >> (I) Rework/Extract/Improve the documentation of stream processing
>> concepts
>> >> (II) Improve & extend Apache Flink's documentation for deployment,
>> >> operations (incl. configuration)
>> >> (III) Add documentation for Flink internals
>> >> (IV) Rework Table API / SQL documentation
>> >>
>> >> We would then get proposals potentially for all of these topics and
>> could
>> >> decide which of these proposals, we would sent back to Google. My
>> feeling
>> >> is that a technical writer could easily spent three months on any of
>> these
>> >> projects. What do others think? Any other project ideas?
>> >>
>> >> Cheers,
>> >>
>> >> Konstantin
>> >>
>> >>
>> >>
>> >>
>> >> On Fri, Apr 12, 2019 at 1:47 PM Jark Wu <[hidden email]> wrote:
>> >>
>> >>> Hi all,
>> >>>
>> >>> I'm fine with only preparing the first proposal. I think it's
>> reasonable
>> >>> because the first proposal is more attractive
>> >>> and maybe there is not enough Chinese writer. We can focus on one
>> project
>> >>> to come up with a concrete and
>> >>> attractive project plan.
>> >>>
>> >>> One possible subproject could be rework Table SQL docs.
>> >>> (1). Improve concepts in Table SQL.
>> >>> (2). A more detailed introduction of built-in functions, currently we
>> >>> only
>> >>> have a simple explanation for each function.
>> >>>       We should add more descriptions, especially more concrete
>> examples,
>> >>> and maybe some notes. We can take
>> >>>       MySQL doc [1] as a reference.
>> >>> (3). As Flink SQL is evolving rapidly and features from Blink is being
>> >>> merged,  for example, SQL DDL, Hive integration,
>> >>>       Python Table API, Interactive Programing, SQL optimization and
>> >>> tuning, etc... We can redesign the doc structure of
>> >>>       Table SQL in a higher vision.
>> >>>
>> >>> Cheers,
>> >>> Jark
>> >>>
>> >>> [1]:
>> >>>
>> >>>
>> https://dev.mysql.com/doc/refman/5.7/en/string-functions.html#function_bin
>> >>>
>> >>>
>> >>>
>> >>> On Fri, 12 Apr 2019 at 18:19, jincheng sun <[hidden email]>
>> >>> wrote:
>> >>>
>> >>> > I am honored to have the opportunity to do a second organization
>> >>> > administrator‘s works!
>> >>> >
>> >>> > It seems that one project and multiple projects have their own
>> >>> advantages.
>> >>> >
>> >>> > My understanding is that even if we only have one project, we also
>> can
>> >>> have
>> >>> > multiple mentors and recruit enough writers.
>> >>> >
>> >>> > Fabian Hueske <[hidden email]> 于2019年4月12日周五 下午5:57写道：
>> >>> >
>> >>> > > Yes, I think we would get at most one project accepted.
>> >>> > > Having all options in a rather generic proposal gives us the most
>> >>> > > flexibility to decide what to work on once the proposal is
>> accepted.
>> >>> > > On the other hand, a more concrete proposal might look more
>> >>> attractive
>> >>> > for
>> >>> > > candidates.
>> >>> > > I'm fine either way, but my gut feeling is that a well scoped
>> >>> proposal
>> >>> > > gives better changes of finding a writer (which might be the
>> biggest
>> >>> > > challenge).
>> >>> > >
>> >>> > > Am Fr., 12. Apr. 2019 um 11:39 Uhr schrieb Stephan Ewen <
>> >>> > [hidden email]
>> >>> > > >:
>> >>> > >
>> >>> > > > I would suggest to make one proposal and have the subsections
>> only
>> >>> in
>> >>> > the
>> >>> > > > project plan.
>> >>> > > > My understanding is that we need to indicate priorities between
>> >>> > proposals
>> >>> > > > and might get only one, so it would be good to not subdivide.
>> >>> > > >
>> >>> > > > On Fri, Apr 12, 2019 at 9:58 AM Fabian Hueske <
>> [hidden email]>
>> >>> > wrote:
>> >>> > > >
>> >>> > > > > Hi everyone,
>> >>> > > > >
>> >>> > > > > I think we can split the first project that Stephan proposed
>> into
>> >>> > > smaller
>> >>> > > > > ones:
>> >>> > > > >
>> >>> > > > > > (1) Create or rework setup / tutorials / concepts docs
>> >>> > > > > > (2) Complete (or advance) the Chinese translation
>> >>> > > > >
>> >>> > > > > 1.1 Improving (extracting) the documentation of stream
>> processing
>> >>> > > > concepts:
>> >>> > > > > Event-time, Timers, State, State Backends, Checkpointing,
>> >>> Savepoints
>> >>> > > > > Right now, the relevant information is scattered across
>> several
>> >>> pages
>> >>> > > and
>> >>> > > > > mixed with the implementation / APIs / configuration options.
>> >>> > > > >
>> >>> > > > > 1.2 Improving & extending the documentation of deployments
>> >>> > > > >
>> >>> > > > > 1.3 Adding documentation in the internals: Distributed
>> >>> architecture,
>> >>> > > > > recovery, operators, job translation, execution, etc.
>> >>> > > > > This documentation would be targeted to Flink developers.
>> >>> > > > >
>> >>> > > > > I thought again about the idea of improving the tutorials, and
>> >>> I'm no
>> >>> > > > > longer sure if this would fit SoD well.
>> >>> > > > > The reason is that creating good tutorials requires a good
>> >>> portion of
>> >>> > > > > coding / configuration (creating Docker images, example
>> programs,
>> >>> > > etc.).
>> >>> > > > > Also I'd like to start improving the situation of tutorials
>> >>> earlier
>> >>> > > than
>> >>> > > > > September.
>> >>> > > > >
>> >>> > > > > What do others think?
>> >>> > > > >
>> >>> > > > > Cheers, Fabian
>> >>> > > > >
>> >>> > > > >
>> >>> > > > > Am Fr., 12. Apr. 2019 um 04:29 Uhr schrieb Jark Wu <
>> >>> [hidden email]
>> >>> > >:
>> >>> > > > >
>> >>> > > > > > Hi Konstantin, Ken,
>> >>> > > > > >
>> >>> > > > > > I agree that Chinese documentation is mainly a translation.
>> >>> > > > > >
>> >>> > > > > > >  Does anyone from the Blink team have input on whether
>> there
>> >>> is
>> >>> > > > > existing,
>> >>> > > > > > original Chinese documentation which should be translated to
>> >>> > English?
>> >>> > > > > >
>> >>> > > > > > There is a public Blink documentation [1] which is English.
>> >>> > > > > > We have a Blink Chinese documentation in internal, but I
>> think
>> >>> we
>> >>> > > need
>> >>> > > > to
>> >>> > > > > > rewrite it in English and restructure it when contributing
>> >>> Blink to
>> >>> > > > > Flink.
>> >>> > > > > >
>> >>> > > > > > Regarding the Chinese translation project, I agree with
>> Ken's
>> >>> > > opinion.
>> >>> > > > > >
>> >>> > > > > > From the point of my translation experience, translation is
>> a
>> >>> work
>> >>> > > that
>> >>> > > > > > need to understand the original English sentence correctly
>> and
>> >>> then
>> >>> > > > > express
>> >>> > > > > > it in Chinese in an easily understandable way. This is not a
>> >>> simple
>> >>> > > > work
>> >>> > > > > > that translate word by word. The one we need is not a
>> >>> "professional
>> >>> > > > > > translator",
>> >>> > > > > > but a "technical writer who are familiar with both
>> >>> languages".  I
>> >>> > > also
>> >>> > > > > > agree that the writer who write the initial documentation
>> has
>> >>> the
>> >>> > > > better
>> >>> > > > > > ability than
>> >>> > > > > > translator to distill complex technical concepts.
>> >>> > > > > >
>> >>> > > > > > [1]: https://flink-china.org/doc/blink
>> >>> > > > > >
>> >>> > > > > > On Fri, 12 Apr 2019 at 02:40, Ken Krugler <
>> >>> > > [hidden email]
>> >>> > > > >
>> >>> > > > > > wrote:
>> >>> > > > > >
>> >>> > > > > > > Hi Konstantin,
>> >>> > > > > > >
>> >>> > > > > > > Comments inline below…
>> >>> > > > > > >
>> >>> > > > > > > — Ken
>> >>> > > > > > >
>> >>> > > > > > > > On Apr 11, 2019, at 9:05 AM, Konstantin Knauf <
>> >>> > > > > > [hidden email]>
>> >>> > > > > > > wrote:
>> >>> > > > > > > >
>> >>> > > > > > > > Hi everyone,
>> >>> > > > > > > >
>> >>> > > > > > > > I will start going through the registration process
>> >>> tomorrow
>> >>> > > (CET).
>> >>> > > > > > > > Jincheng (cc) reached out to me directly and offered to
>> be
>> >>> the
>> >>> > > > second
>> >>> > > > > > > > organization administrator. So, we are all set in that
>> >>> regard.
>> >>> > > > > > > >
>> >>> > > > > > > > In terms of mentors, we now have
>> >>> > > > > > > >
>> >>> > > > > > > > * myself
>> >>> > > > > > > > * Fabian
>> >>> > > > > > > > * David
>> >>> > > > > > > > * Stephan
>> >>> > > > > > > > * Jark (Chinese Translation)
>> >>> > > > > > > >
>> >>> > > > > > > > Regarding the Chinese translation project, it is
>> probably a
>> >>> > > > question
>> >>> > > > > of
>> >>> > > > > > > how
>> >>> > > > > > > > independent the Chinese version is supposed to be. If
>> the
>> >>> > English
>> >>> > > > > > > > documentation is the ground-truth and the Chinese
>> >>> documentation
>> >>> > > is
>> >>> > > > > > > (mainly)
>> >>> > > > > > > > a translation, I agree with Stefan. If the Chinese
>> >>> > documentation
>> >>> > > is
>> >>> > > > > > > > supposed to become an independent secondary
>> documentation,
>> >>> it
>> >>> > > could
>> >>> > > > > be
>> >>> > > > > > a
>> >>> > > > > > > > project for a technical writer as well. Has this
>> questions
>> >>> > > already
>> >>> > > > > been
>> >>> > > > > > > > discussed in the community?
>> >>> > > > > > >
>> >>> > > > > > > My understanding is that the Chinese documentation is
>> going
>> >>> to
>> >>> > > mostly
>> >>> > > > > be
>> >>> > > > > > a
>> >>> > > > > > > translation of the English versions.
>> >>> > > > > > >
>> >>> > > > > > > Though perhaps, with all of the Blink integration going
>> on,
>> >>> the
>> >>> > > > inverse
>> >>> > > > > > > could also be true.
>> >>> > > > > > >
>> >>> > > > > > > Does anyone from the Blink team have input on whether
>> there
>> >>> is
>> >>> > > > > existing,
>> >>> > > > > > > original Chinese documentation which should be translated
>> to
>> >>> > > English?
>> >>> > > > > > >
>> >>> > > > > > > > On Thu, Apr 11, 2019 at 11:34 AM Stephan Ewen <
>> >>> > [hidden email]>
>> >>> > > > > > wrote:
>> >>> > > > > > > >
>> >>> > > > > > > >> So we have two ideas for docs projects now:
>> >>> > > > > > > >>
>> >>> > > > > > > >> (1) Create or rework setup / tutorials / concepts docs
>> >>> > > > > > > >> (2) Complete (or advance) the Chinese translation
>> >>> > > > > > > >>
>> >>> > > > > > > >> Should we apply for both (and let the SoD committee
>> select
>> >>> > > > whichever
>> >>> > > > > > > they
>> >>> > > > > > > >> want to sponsor) or select one of them?
>> >>> > > > > > > >>
>> >>> > > > > > > >> For project (2), this sounds to me more like a project
>> >>> for a
>> >>> > > > > > > "translator",
>> >>> > > > > > > >> not a "technical writer". As far as I understand it,
>> the
>> >>> big
>> >>> > > > benefit
>> >>> > > > > > of
>> >>> > > > > > > >> having a technical writer is to have someone who can
>> >>> describe
>> >>> > > > > > > complicated
>> >>> > > > > > > >> technical concepts (that engineers describe in
>> complicated
>> >>> > > > language)
>> >>> > > > > > in
>> >>> > > > > > > an
>> >>> > > > > > > >> easily understandable way.
>> >>> > > > > > >
>> >>> > > > > > > Actually a good Chinese translation of the technical docs
>> >>> > requires
>> >>> > > > > > someone
>> >>> > > > > > > with many of the same skills. In order for the translation
>> >>> to be
>> >>> > > > > > accurate,
>> >>> > > > > > > you need someone who understands the concepts of the
>> >>> underlying
>> >>> > > > > > technology,
>> >>> > > > > > > to use appropriate terminology. Though I agree that the
>> >>> ability
>> >>> > to
>> >>> > > > > > distill
>> >>> > > > > > > complex technical concepts is more important when writing
>> >>> initial
>> >>> > > > > > > documentation.
>> >>> > > > > > >
>> >>> > > > > > >
>> >>> > > > > > > >> On Thu, Apr 11, 2019 at 9:47 AM Fabian Hueske <
>> >>> > > [hidden email]>
>> >>> > > > > > > wrote:
>> >>> > > > > > > >>
>> >>> > > > > > > >>> Thanks for the clarification Aizhamal!
>> >>> > > > > > > >>> This is really helpful and will make it a lot easier
>> to
>> >>> > > > coordinate
>> >>> > > > > > :-)
>> >>> > > > > > > >>>
>> >>> > > > > > > >>> As for next steps, I found this email on the
>> >>> > > > > > [hidden email]
>> >>> > > > > > > >>> mailing list:
>> >>> > > > > > > >>>
>> >>> > > > > > > >>> ==================================================
>> >>> > > > > > > >>> Hi All,
>> >>> > > > > > > >>>
>> >>> > > > > > > >>> As mentioned the applications for the Google Season of
>> >>> Docs
>> >>> > > > opened
>> >>> > > > > > > today
>> >>> > > > > > > >>> and I'm working my way through it on behalf of the
>> ASF.
>> >>> > > > > > > >>>
>> >>> > > > > > > >>> If accepted, we will be allocated either one or two
>> >>> techical
>> >>> > > > > writers.
>> >>> > > > > > > >>> Google will also pay the ASF a stipend of $500 per
>> >>> technical
>> >>> > > > writer
>> >>> > > > > > > >>> mentored (which I hope can go directly to fundraising
>> :-)
>> >>> > > > > > > >>>
>> >>> > > > > > > >>> Each project that wants to participate must provide
>> two
>> >>> > mentors
>> >>> > > > for
>> >>> > > > > > > each
>> >>> > > > > > > >>> documentation project.
>> >>> > > > > > > >>>
>> >>> > > > > > > >>> As part of the application process there are a few
>> things
>> >>> > that
>> >>> > > we
>> >>> > > > > > need
>> >>> > > > > > > to
>> >>> > > > > > > >>> setup.
>> >>> > > > > > > >>>
>> >>> > > > > > > >>> 1. Season of Docs Page and List of Project Ideas
>> >>> > > > > > > >>> We need to create a public webpage about Season of
>> Docs
>> >>> that
>> >>> > > > > contains
>> >>> > > > > > > the
>> >>> > > > > > > >>> list of project ideas for documentation. I have
>> created a
>> >>> > page
>> >>> > > on
>> >>> > > > > the
>> >>> > > > > > > >>> ComDev wiki https://s.apache.org/w4CH  with a table
>> for
>> >>> > > projects
>> >>> > > > > to
>> >>> > > > > > > >> record
>> >>> > > > > > > >>> their ideas.
>> >>> > > > > > > >>>
>> >>> > > > > > > >>> 2. Alternative administrator.
>> >>> > > > > > > >>> I’ve set myself up as the primary admin and Maxim as
>> the
>> >>> > > > > alternative
>> >>> > > > > > > >> admin
>> >>> > > > > > > >>> (Maxim, I need to confirm your contact email and you
>> will
>> >>> > also
>> >>> > > > need
>> >>> > > > > > to
>> >>> > > > > > > >>> register as the alternative admin and I will email you
>> >>> the
>> >>> > link
>> >>> > > > > > > offline)
>> >>> > > > > > > >>>
>> >>> > > > > > > >>> 3. Mentors
>> >>> > > > > > > >>> All mentors from the projects interested in
>> participating
>> >>> > must
>> >>> > > > > > register
>> >>> > > > > > > >>> individually at the following link :
>> >>> > > > > > > https://forms.gle/a1x26WQGzURLerv66
>> >>> > > > > > > >> .
>> >>> > > > > > > >>>
>> >>> > > > > > > >>> 4. Application Form: Documentation / Technnial Writer
>> >>> > > > Collaboration
>> >>> > > > > > > >>> There is a section to fill in about experience with
>> >>> > > documentation
>> >>> > > > > and
>> >>> > > > > > > any
>> >>> > > > > > > >>> previous collaboration with technical writers. I know
>> a
>> >>> few
>> >>> > > > > projects
>> >>> > > > > > > have
>> >>> > > > > > > >>> used various tools for documentation - but not sure
>> >>> about any
>> >>> > > > > > technical
>> >>> > > > > > > >>> writing collaboration (so if you know of any then
>> please
>> >>> let
>> >>> > me
>> >>> > > > > know)
>> >>> > > > > > > >>>
>> >>> > > > > > > >>> 5. Application Form: GSoC
>> >>> > > > > > > >>> There is a section to complete at our participation in
>> >>> GSoC.I
>> >>> > > > > think I
>> >>> > > > > > > >> have
>> >>> > > > > > > >>> the details from our application this year so can
>> follow
>> >>> up
>> >>> > > with
>> >>> > > > > > Maxim
>> >>> > > > > > > or
>> >>> > > > > > > >>> Uli about it
>> >>> > > > > > > >>>
>> >>> > > > > > > >>> This is all I have at the moment and we have until the
>> >>> 23rd
>> >>> > > April
>> >>> > > > > > 2019
>> >>> > > > > > > to
>> >>> > > > > > > >>> finalise all the application details. Ideally I want
>> to
>> >>> have
>> >>> > it
>> >>> > > > > done
>> >>> > > > > > > well
>> >>> > > > > > > >>> before then :-)
>> >>> > > > > > > >>>
>> >>> > > > > > > >>> Please pass on this information within your various
>> >>> projects
>> >>> > > and
>> >>> > > > as
>> >>> > > > > > > with
>> >>> > > > > > > >>> GSoC - I'll see how we can get this information out to
>> >>> all
>> >>> > our
>> >>> > > > > > project
>> >>> > > > > > > >>> mailing lists.
>> >>> > > > > > > >>>
>> >>> > > > > > > >>> Thanks
>> >>> > > > > > > >>> Sharan
>> >>> > > > > > > >>>
>> >>> > > > > > > >>> ==================================================
>> >>> > > > > > > >>>
>> >>> > > > > > > >>> I guess, we would need to follow these steps as well.
>> >>> > > > > > > >>>
>> >>> > > > > > > >>> Best,
>> >>> > > > > > > >>> Fabian
>> >>> > > > > > > >>>
>> >>> > > > > > > >>> Am Do., 11. Apr. 2019 um 05:08 Uhr schrieb Jark Wu <
>> >>> > > > > [hidden email]
>> >>> > > > > > >:
>> >>> > > > > > > >>>
>> >>> > > > > > > >>>> Hi Aizhamal,
>> >>> > > > > > > >>>>
>> >>> > > > > > > >>>> That's really interesting. We have an ongoing
>> proposal
>> >>> for
>> >>> > > > > > supporting
>> >>> > > > > > > >>>> Chinese documentation, see FLIP-35 [1].
>> >>> > > > > > > >>>>
>> >>> > > > > > > >>>> I think it's a good idea to propose Chinese
>> translation
>> >>> as a
>> >>> > > > > > project.
>> >>> > > > > > > >>> It's
>> >>> > > > > > > >>>> a good chance to improve the localization user
>> >>> experience of
>> >>> > > > Flink
>> >>> > > > > > > >>>> documentation.
>> >>> > > > > > > >>>> I can help as a mentor if we want to submit such a
>> >>> project.
>> >>> > > > > > > >>>>
>> >>> > > > > > > >>>> Thanks,
>> >>> > > > > > > >>>> Jark Wu
>> >>> > > > > > > >>>>
>> >>> > > > > > > >>>> [1]:
>> >>> > > > > > > >>>>
>> >>> > > > > > > >>>
>> >>> > > > > > > >>
>> >>> > > > > > >
>> >>> > > > > >
>> >>> > > > >
>> >>> > > >
>> >>> > >
>> >>> >
>> >>>
>> https://cwiki.apache.org/confluence/display/FLINK/FLIP-35%3A+Support+Chinese+Documents+and+Website
>> >>> > > > > > > >>>>
>> >>> > > > > > > >>>> On Thu, 11 Apr 2019 at 02:11, Aizhamal Nurmamat kyzy
>> >>> > > > > > > >>>> <[hidden email]> wrote:
>> >>> > > > > > > >>>>
>> >>> > > > > > > >>>>> Hello everyone,
>> >>> > > > > > > >>>>>
>> >>> > > > > > > >>>>> @Fabian Hueske <[hidden email]> - SoD setup is a
>> >>> little
>> >>> > > bit
>> >>> > > > > > > >>> different.
>> >>> > > > > > > >>>>> The ASF determined that each project would be
>> allowed
>> >>> to
>> >>> > > apply
>> >>> > > > > > > >>>>> individually[1], rather than applying as a single
>> large
>> >>> > > > > > organization.
>> >>> > > > > > > >>>>>
>> >>> > > > > > > >>>>> Each project applies as an org, with two organizers
>> >>> > > > (administers)
>> >>> > > > > > and
>> >>> > > > > > > >> at
>> >>> > > > > > > >>>>> least two mentors. As Konstantin pointed out, one
>> can
>> >>> be
>> >>> > both
>> >>> > > > an
>> >>> > > > > > > >>>>> administer
>> >>> > > > > > > >>>>> and a mentor. You don't need to coordinate with
>> other
>> >>> > > projects
>> >>> > > > or
>> >>> > > > > > ASF
>> >>> > > > > > > >> at
>> >>> > > > > > > >>>>> all. If accepted to the program, you will receive
>> >>> project
>> >>> > > > > proposals
>> >>> > > > > > > >> from
>> >>> > > > > > > >>>>> tech writers [2]. You will choose one or two
>> proposals
>> >>> that
>> >>> > > you
>> >>> > > > > > want
>> >>> > > > > > > >> to
>> >>> > > > > > > >>>>> mentor[3].
>> >>> > > > > > > >>>>>
>> >>> > > > > > > >>>>> @Ken - as for the language, there isn’t any
>> >>> limitations in
>> >>> > > that
>> >>> > > > > > > >> regard,
>> >>> > > > > > > >>> so
>> >>> > > > > > > >>>>> work on the Chinese translation for the website is
>> >>> > definitely
>> >>> > > > an
>> >>> > > > > > > >>>>> acceptable
>> >>> > > > > > > >>>>> project.
>> >>> > > > > > > >>>>>
>> >>> > > > > > > >>>>> Thanks,
>> >>> > > > > > > >>>>>
>> >>> > > > > > > >>>>> Aizhamal
>> >>> > > > > > > >>>>>
>> >>> > > > > > > >>>>>
>> >>> > > > > > > >>>>> [1]
>> >>> > > > > > > >>>>>
>> >>> > > > > > > >>>>>
>> >>> > > > > > > >>>
>> >>> > > > > > > >>
>> >>> > > > > > >
>> >>> > > > > >
>> >>> > > > >
>> >>> > > >
>> >>> > >
>> >>> >
>> >>>
>> https://lists.apache.org/thread.html/67e1c2e6041cff1e7f198b615407401f032795130e796adfaacf8071@%3Cdev.community.apache.org%3E
>> >>> > > > > > > >>>>>
>> >>> > > > > > > >>>>> [2]
>> https://developers.google.com/season-of-docs/docs/
>> >>> > > > > > > >>>>>
>> >>> > > > > > > >>>>> [3]
>> >>> > > > > > > >>>
>> >>> > > > > >
>> >>> > >
>> >>> https://developers.google.com/season-of-docs/docs/faq#slot-allocation
>> >>> > > > > > > >>>>>
>> >>> > > > > > > >>>>>
>> >>> > > > > > > >>>>> On Wed, Apr 10, 2019 at 8:32 AM Ken Krugler <
>> >>> > > > > > > >>> [hidden email]>
>> >>> > > > > > > >>>>> wrote:
>> >>> > > > > > > >>>>>
>> >>> > > > > > > >>>>>> Hi Aizhamal,
>> >>> > > > > > > >>>>>>
>> >>> > > > > > > >>>>>> I assume SoD is language-agnostic, so one possible
>> >>> project
>> >>> > > > would
>> >>> > > > > > be
>> >>> > > > > > > >> to
>> >>> > > > > > > >>>>> get
>> >>> > > > > > > >>>>>> a tech writer for the Chinese versions of all of
>> the
>> >>> Flink
>> >>> > > > > > > >>>>> documentation,
>> >>> > > > > > > >>>>>> yes?
>> >>> > > > > > > >>>>>>
>> >>> > > > > > > >>>>>> Regards,
>> >>> > > > > > > >>>>>>
>> >>> > > > > > > >>>>>> — Ken
>> >>> > > > > > > >>>>>>
>> >>> > > > > > > >>>>>>> On Apr 5, 2019, at 3:43 PM, Aizhamal Nurmamat kyzy
>> >>> > > > > > > >>>>>> <[hidden email]> wrote:
>> >>> > > > > > > >>>>>>>
>> >>> > > > > > > >>>>>>> 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
>> >>> > > > > > >
>> >>> > > > > > > --------------------------
>> >>> > > > > > > Ken Krugler
>> >>> > > > > > > [phone]
>> >>> > > > > > > http://www.scaleunlimited.com
>> >>> > > > > > > Custom big data solutions & training
>> >>> > > > > > > Flink, Solr, Hadoop, Cascading & Cassandra
>> >>> > > > > > >
>> >>> > > > > > >
>> >>> > > > > >
>> >>> > > > >
>> >>> > > >
>> >>> > >
>> >>> >
>> >>>
>> >>
>> >>
>> >> --
>> >>
>> >> Konstantin Knauf | Solutions Architect
>> >>
>> >> [phone]
>> >>
>> >> <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
>> >>
>> >
>>
>> --
>>
>> Konstantin Knauf | Solutions Architect
>>
>> [phone]
>>
>> <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
>>
>

[Konstantin Knauf-3]

Hi everyone,

a few updates on our application:

1. As Aizhamal (Thanks!) has suggested I also added the information to
submit during our application to the Google doc [1] and Fabian added a
description for the SQL project idea (Thanks!).

2. I had a quick chat with Fabian offline and we concluded, that the "Flink
Internals" project might not be good fit for Season of Docs after all,
because, we think, the amount of mentoring by core developers that would be
necessary to produce such a documentation could not be guaranteed. Any
opinions?

3. To submit our application, we need to publish our project ideas list.
For this I have just opened a PR to add a small blog post about Season of
Docs [2]. Please have a look and provide feedback.

4. For mentors (Stephan, Fabian, Jark, David) please complete the mentor
registration [3] by next Tuesday (*Application Deadline*)

Cheers,

Konstantin

[1]
https://docs.google.com/document/d/1Up53jNsLztApn-mP76AB6xWUVGt3nwS9p6xQTiceKXo/edit?usp=sharing
[2] https://github.com/apache/flink-web/pull/202
[3]
https://docs.google.com/forms/d/e/1FAIpQLSe-JjGvaKKGWZOXxrorONhB8qN3mjPrB9ZVkcsntR73Cv_K7g/viewform

On Mon, Apr 15, 2019 at 9:12 PM Aizhamal Nurmamat kyzy <[hidden email]>
wrote:

> +Konstantin Knauf <[hidden email]> this is looking good, thanks
> for sharing!
>
> I also created a similar doc for Apache Airflow [1]. It is a bit messy,
> but it has questions from the application form that you can work with.
>
> Cheers,
> Aizhamal
>
> [1]
> https://docs.google.com/document/d/1HoL_yjNYiTAP9IxSlhx3EUnPFU4l9WOT9EnwBZjCZo0/edit#
>
>
> On Mon, Apr 15, 2019 at 2:24 AM Robert Metzger <[hidden email]>
> wrote:
>
>> Hi all,
>> I'm very happy to see this project happening!
>>
>> Thank you for the proposal Konstantin! One idea for the "related
>> material": we could also link to talks or blog posts about concepts /
>> monitoring / operations. Potential writers could feel overwhelmed by our
>> demand for improvements, without any additional material.
>>
>>
>> On Mon, Apr 15, 2019 at 10:16 AM Konstantin Knauf <
>> [hidden email]> wrote:
>>
>>> Hi everyone,
>>>
>>> thanks @Aizhamal Nurmamat kyzy <[hidden email]>. As we only have
>>> one
>>> week left until the application deadline, I went ahead and created a
>>> document for the project ideas [1]. I have added the description for the
>>> "stream processing concepts" as well as the "deployment & operations
>>> documentation" project idea. Please let me know what you think, edit &
>>> comment. We also need descriptions for the other two projects (Table
>>> API/SQL & Flink Internals). @Fabian/@Jark/@Stephan can you chime in?
>>>
>>> Any more project ideas?
>>>
>>> Best,
>>>
>>> Konstantin
>>>
>>>
>>> [1]
>>>
>>> https://docs.google.com/document/d/1Up53jNsLztApn-mP76AB6xWUVGt3nwS9p6xQTiceKXo/edit?usp=sharing
>>>
>>>
>>>
>>> On Fri, Apr 12, 2019 at 6:50 PM Aizhamal Nurmamat kyzy <
>>> [hidden email]>
>>> wrote:
>>>
>>> > Hello everyone,
>>> >
>>> > @Konstantin Knauf <[hidden email]> - yes, you are correct.
>>> > Between steps 1 and 2 though, the open source organization, in this
>>> case
>>> > Flink, has to be selected by SoD as one of the participating orgs
>>> *fingers
>>> > crossed*.
>>> >
>>> > One tip about organizing ideas is that you want to communicate
>>> potential
>>> > projects to the tech writers that are applying. Just make sure the
>>> scope of
>>> > the project is clear to them. The SoD wants to set up the tech writers
>>> for
>>> > success by making sure the work can be done in the allotted time.
>>> >
>>> > Hope it helps.
>>> >
>>> > Aizhamal
>>> >
>>> >
>>> >
>>> > On Fri, Apr 12, 2019 at 7:37 AM Konstantin Knauf <
>>> [hidden email]>
>>> > wrote:
>>> >
>>> >> Hi all,
>>> >>
>>> >> I read through the SoD documentation again, and now I think, it would
>>> >> actually make sense to split (1) up into multiple project ideas. Let
>>> me
>>> >> summarize the overall process:
>>> >>
>>> >> 1. We create & publish a list of project ideas, e.g. in a blog post.
>>> >> (This can be any number of ideas.)
>>> >> 2. Potential technical writers look at our list of ideas and sent a
>>> >> proposal for a particular project to Google. During that time they can
>>> >> reach out to us for clarification.
>>> >> 3. Google forwards all proposals for our project ideas to us and we
>>> sent
>>> >> back a prioritized list of proposals, which we would like to accept.
>>> >> 4. Of all these proposals, Google accepts 50 proposals for SoD 2019.
>>> Per
>>> >> organization Google will only accept a maximum of two proposals.
>>> >>
>>> >> @Aizhamal Nurmamat kyzy <[hidden email]> Please correct me!
>>> >>
>>> >> For me this means we should splits this up in a way, that each
>>> project is
>>> >> a) still relevant in September b) makes sense as a 3 month project.
>>> Based
>>> >> on the ideas we have right now these could for example be:
>>> >>
>>> >> (I) Rework/Extract/Improve the documentation of stream processing
>>> concepts
>>> >> (II) Improve & extend Apache Flink's documentation for deployment,
>>> >> operations (incl. configuration)
>>> >> (III) Add documentation for Flink internals
>>> >> (IV) Rework Table API / SQL documentation
>>> >>
>>> >> We would then get proposals potentially for all of these topics and
>>> could
>>> >> decide which of these proposals, we would sent back to Google. My
>>> feeling
>>> >> is that a technical writer could easily spent three months on any of
>>> these
>>> >> projects. What do others think? Any other project ideas?
>>> >>
>>> >> Cheers,
>>> >>
>>> >> Konstantin
>>> >>
>>> >>
>>> >>
>>> >>
>>> >> On Fri, Apr 12, 2019 at 1:47 PM Jark Wu <[hidden email]> wrote:
>>> >>
>>> >>> Hi all,
>>> >>>
>>> >>> I'm fine with only preparing the first proposal. I think it's
>>> reasonable
>>> >>> because the first proposal is more attractive
>>> >>> and maybe there is not enough Chinese writer. We can focus on one
>>> project
>>> >>> to come up with a concrete and
>>> >>> attractive project plan.
>>> >>>
>>> >>> One possible subproject could be rework Table SQL docs.
>>> >>> (1). Improve concepts in Table SQL.
>>> >>> (2). A more detailed introduction of built-in functions, currently we
>>> >>> only
>>> >>> have a simple explanation for each function.
>>> >>>       We should add more descriptions, especially more concrete
>>> examples,
>>> >>> and maybe some notes. We can take
>>> >>>       MySQL doc [1] as a reference.
>>> >>> (3). As Flink SQL is evolving rapidly and features from Blink is
>>> being
>>> >>> merged,  for example, SQL DDL, Hive integration,
>>> >>>       Python Table API, Interactive Programing, SQL optimization and
>>> >>> tuning, etc... We can redesign the doc structure of
>>> >>>       Table SQL in a higher vision.
>>> >>>
>>> >>> Cheers,
>>> >>> Jark
>>> >>>
>>> >>> [1]:
>>> >>>
>>> >>>
>>> https://dev.mysql.com/doc/refman/5.7/en/string-functions.html#function_bin
>>> >>>
>>> >>>
>>> >>>
>>> >>> On Fri, 12 Apr 2019 at 18:19, jincheng sun <[hidden email]
>>> >
>>> >>> wrote:
>>> >>>
>>> >>> > I am honored to have the opportunity to do a second organization
>>> >>> > administrator‘s works!
>>> >>> >
>>> >>> > It seems that one project and multiple projects have their own
>>> >>> advantages.
>>> >>> >
>>> >>> > My understanding is that even if we only have one project, we also
>>> can
>>> >>> have
>>> >>> > multiple mentors and recruit enough writers.
>>> >>> >
>>> >>> > Fabian Hueske <[hidden email]> 于2019年4月12日周五 下午5:57写道：
>>> >>> >
>>> >>> > > Yes, I think we would get at most one project accepted.
>>> >>> > > Having all options in a rather generic proposal gives us the most
>>> >>> > > flexibility to decide what to work on once the proposal is
>>> accepted.
>>> >>> > > On the other hand, a more concrete proposal might look more
>>> >>> attractive
>>> >>> > for
>>> >>> > > candidates.
>>> >>> > > I'm fine either way, but my gut feeling is that a well scoped
>>> >>> proposal
>>> >>> > > gives better changes of finding a writer (which might be the
>>> biggest
>>> >>> > > challenge).
>>> >>> > >
>>> >>> > > Am Fr., 12. Apr. 2019 um 11:39 Uhr schrieb Stephan Ewen <
>>> >>> > [hidden email]
>>> >>> > > >:
>>> >>> > >
>>> >>> > > > I would suggest to make one proposal and have the subsections
>>> only
>>> >>> in
>>> >>> > the
>>> >>> > > > project plan.
>>> >>> > > > My understanding is that we need to indicate priorities between
>>> >>> > proposals
>>> >>> > > > and might get only one, so it would be good to not subdivide.
>>> >>> > > >
>>> >>> > > > On Fri, Apr 12, 2019 at 9:58 AM Fabian Hueske <
>>> [hidden email]>
>>> >>> > wrote:
>>> >>> > > >
>>> >>> > > > > Hi everyone,
>>> >>> > > > >
>>> >>> > > > > I think we can split the first project that Stephan proposed
>>> into
>>> >>> > > smaller
>>> >>> > > > > ones:
>>> >>> > > > >
>>> >>> > > > > > (1) Create or rework setup / tutorials / concepts docs
>>> >>> > > > > > (2) Complete (or advance) the Chinese translation
>>> >>> > > > >
>>> >>> > > > > 1.1 Improving (extracting) the documentation of stream
>>> processing
>>> >>> > > > concepts:
>>> >>> > > > > Event-time, Timers, State, State Backends, Checkpointing,
>>> >>> Savepoints
>>> >>> > > > > Right now, the relevant information is scattered across
>>> several
>>> >>> pages
>>> >>> > > and
>>> >>> > > > > mixed with the implementation / APIs / configuration options.
>>> >>> > > > >
>>> >>> > > > > 1.2 Improving & extending the documentation of deployments
>>> >>> > > > >
>>> >>> > > > > 1.3 Adding documentation in the internals: Distributed
>>> >>> architecture,
>>> >>> > > > > recovery, operators, job translation, execution, etc.
>>> >>> > > > > This documentation would be targeted to Flink developers.
>>> >>> > > > >
>>> >>> > > > > I thought again about the idea of improving the tutorials,
>>> and
>>> >>> I'm no
>>> >>> > > > > longer sure if this would fit SoD well.
>>> >>> > > > > The reason is that creating good tutorials requires a good
>>> >>> portion of
>>> >>> > > > > coding / configuration (creating Docker images, example
>>> programs,
>>> >>> > > etc.).
>>> >>> > > > > Also I'd like to start improving the situation of tutorials
>>> >>> earlier
>>> >>> > > than
>>> >>> > > > > September.
>>> >>> > > > >
>>> >>> > > > > What do others think?
>>> >>> > > > >
>>> >>> > > > > Cheers, Fabian
>>> >>> > > > >
>>> >>> > > > >
>>> >>> > > > > Am Fr., 12. Apr. 2019 um 04:29 Uhr schrieb Jark Wu <
>>> >>> [hidden email]
>>> >>> > >:
>>> >>> > > > >
>>> >>> > > > > > Hi Konstantin, Ken,
>>> >>> > > > > >
>>> >>> > > > > > I agree that Chinese documentation is mainly a translation.
>>> >>> > > > > >
>>> >>> > > > > > >  Does anyone from the Blink team have input on whether
>>> there
>>> >>> is
>>> >>> > > > > existing,
>>> >>> > > > > > original Chinese documentation which should be translated
>>> to
>>> >>> > English?
>>> >>> > > > > >
>>> >>> > > > > > There is a public Blink documentation [1] which is English.
>>> >>> > > > > > We have a Blink Chinese documentation in internal, but I
>>> think
>>> >>> we
>>> >>> > > need
>>> >>> > > > to
>>> >>> > > > > > rewrite it in English and restructure it when contributing
>>> >>> Blink to
>>> >>> > > > > Flink.
>>> >>> > > > > >
>>> >>> > > > > > Regarding the Chinese translation project, I agree with
>>> Ken's
>>> >>> > > opinion.
>>> >>> > > > > >
>>> >>> > > > > > From the point of my translation experience, translation
>>> is a
>>> >>> work
>>> >>> > > that
>>> >>> > > > > > need to understand the original English sentence correctly
>>> and
>>> >>> then
>>> >>> > > > > express
>>> >>> > > > > > it in Chinese in an easily understandable way. This is not
>>> a
>>> >>> simple
>>> >>> > > > work
>>> >>> > > > > > that translate word by word. The one we need is not a
>>> >>> "professional
>>> >>> > > > > > translator",
>>> >>> > > > > > but a "technical writer who are familiar with both
>>> >>> languages".  I
>>> >>> > > also
>>> >>> > > > > > agree that the writer who write the initial documentation
>>> has
>>> >>> the
>>> >>> > > > better
>>> >>> > > > > > ability than
>>> >>> > > > > > translator to distill complex technical concepts.
>>> >>> > > > > >
>>> >>> > > > > > [1]: https://flink-china.org/doc/blink
>>> >>> > > > > >
>>> >>> > > > > > On Fri, 12 Apr 2019 at 02:40, Ken Krugler <
>>> >>> > > [hidden email]
>>> >>> > > > >
>>> >>> > > > > > wrote:
>>> >>> > > > > >
>>> >>> > > > > > > Hi Konstantin,
>>> >>> > > > > > >
>>> >>> > > > > > > Comments inline below…
>>> >>> > > > > > >
>>> >>> > > > > > > — Ken
>>> >>> > > > > > >
>>> >>> > > > > > > > On Apr 11, 2019, at 9:05 AM, Konstantin Knauf <
>>> >>> > > > > > [hidden email]>
>>> >>> > > > > > > wrote:
>>> >>> > > > > > > >
>>> >>> > > > > > > > Hi everyone,
>>> >>> > > > > > > >
>>> >>> > > > > > > > I will start going through the registration process
>>> >>> tomorrow
>>> >>> > > (CET).
>>> >>> > > > > > > > Jincheng (cc) reached out to me directly and offered
>>> to be
>>> >>> the
>>> >>> > > > second
>>> >>> > > > > > > > organization administrator. So, we are all set in that
>>> >>> regard.
>>> >>> > > > > > > >
>>> >>> > > > > > > > In terms of mentors, we now have
>>> >>> > > > > > > >
>>> >>> > > > > > > > * myself
>>> >>> > > > > > > > * Fabian
>>> >>> > > > > > > > * David
>>> >>> > > > > > > > * Stephan
>>> >>> > > > > > > > * Jark (Chinese Translation)
>>> >>> > > > > > > >
>>> >>> > > > > > > > Regarding the Chinese translation project, it is
>>> probably a
>>> >>> > > > question
>>> >>> > > > > of
>>> >>> > > > > > > how
>>> >>> > > > > > > > independent the Chinese version is supposed to be. If
>>> the
>>> >>> > English
>>> >>> > > > > > > > documentation is the ground-truth and the Chinese
>>> >>> documentation
>>> >>> > > is
>>> >>> > > > > > > (mainly)
>>> >>> > > > > > > > a translation, I agree with Stefan. If the Chinese
>>> >>> > documentation
>>> >>> > > is
>>> >>> > > > > > > > supposed to become an independent secondary
>>> documentation,
>>> >>> it
>>> >>> > > could
>>> >>> > > > > be
>>> >>> > > > > > a
>>> >>> > > > > > > > project for a technical writer as well. Has this
>>> questions
>>> >>> > > already
>>> >>> > > > > been
>>> >>> > > > > > > > discussed in the community?
>>> >>> > > > > > >
>>> >>> > > > > > > My understanding is that the Chinese documentation is
>>> going
>>> >>> to
>>> >>> > > mostly
>>> >>> > > > > be
>>> >>> > > > > > a
>>> >>> > > > > > > translation of the English versions.
>>> >>> > > > > > >
>>> >>> > > > > > > Though perhaps, with all of the Blink integration going
>>> on,
>>> >>> the
>>> >>> > > > inverse
>>> >>> > > > > > > could also be true.
>>> >>> > > > > > >
>>> >>> > > > > > > Does anyone from the Blink team have input on whether
>>> there
>>> >>> is
>>> >>> > > > > existing,
>>> >>> > > > > > > original Chinese documentation which should be
>>> translated to
>>> >>> > > English?
>>> >>> > > > > > >
>>> >>> > > > > > > > On Thu, Apr 11, 2019 at 11:34 AM Stephan Ewen <
>>> >>> > [hidden email]>
>>> >>> > > > > > wrote:
>>> >>> > > > > > > >
>>> >>> > > > > > > >> So we have two ideas for docs projects now:
>>> >>> > > > > > > >>
>>> >>> > > > > > > >> (1) Create or rework setup / tutorials / concepts docs
>>> >>> > > > > > > >> (2) Complete (or advance) the Chinese translation
>>> >>> > > > > > > >>
>>> >>> > > > > > > >> Should we apply for both (and let the SoD committee
>>> select
>>> >>> > > > whichever
>>> >>> > > > > > > they
>>> >>> > > > > > > >> want to sponsor) or select one of them?
>>> >>> > > > > > > >>
>>> >>> > > > > > > >> For project (2), this sounds to me more like a project
>>> >>> for a
>>> >>> > > > > > > "translator",
>>> >>> > > > > > > >> not a "technical writer". As far as I understand it,
>>> the
>>> >>> big
>>> >>> > > > benefit
>>> >>> > > > > > of
>>> >>> > > > > > > >> having a technical writer is to have someone who can
>>> >>> describe
>>> >>> > > > > > > complicated
>>> >>> > > > > > > >> technical concepts (that engineers describe in
>>> complicated
>>> >>> > > > language)
>>> >>> > > > > > in
>>> >>> > > > > > > an
>>> >>> > > > > > > >> easily understandable way.
>>> >>> > > > > > >
>>> >>> > > > > > > Actually a good Chinese translation of the technical docs
>>> >>> > requires
>>> >>> > > > > > someone
>>> >>> > > > > > > with many of the same skills. In order for the
>>> translation
>>> >>> to be
>>> >>> > > > > > accurate,
>>> >>> > > > > > > you need someone who understands the concepts of the
>>> >>> underlying
>>> >>> > > > > > technology,
>>> >>> > > > > > > to use appropriate terminology. Though I agree that the
>>> >>> ability
>>> >>> > to
>>> >>> > > > > > distill
>>> >>> > > > > > > complex technical concepts is more important when writing
>>> >>> initial
>>> >>> > > > > > > documentation.
>>> >>> > > > > > >
>>> >>> > > > > > >
>>> >>> > > > > > > >> On Thu, Apr 11, 2019 at 9:47 AM Fabian Hueske <
>>> >>> > > [hidden email]>
>>> >>> > > > > > > wrote:
>>> >>> > > > > > > >>
>>> >>> > > > > > > >>> Thanks for the clarification Aizhamal!
>>> >>> > > > > > > >>> This is really helpful and will make it a lot easier
>>> to
>>> >>> > > > coordinate
>>> >>> > > > > > :-)
>>> >>> > > > > > > >>>
>>> >>> > > > > > > >>> As for next steps, I found this email on the
>>> >>> > > > > > [hidden email]
>>> >>> > > > > > > >>> mailing list:
>>> >>> > > > > > > >>>
>>> >>> > > > > > > >>> ==================================================
>>> >>> > > > > > > >>> Hi All,
>>> >>> > > > > > > >>>
>>> >>> > > > > > > >>> As mentioned the applications for the Google Season
>>> of
>>> >>> Docs
>>> >>> > > > opened
>>> >>> > > > > > > today
>>> >>> > > > > > > >>> and I'm working my way through it on behalf of the
>>> ASF.
>>> >>> > > > > > > >>>
>>> >>> > > > > > > >>> If accepted, we will be allocated either one or two
>>> >>> techical
>>> >>> > > > > writers.
>>> >>> > > > > > > >>> Google will also pay the ASF a stipend of $500 per
>>> >>> technical
>>> >>> > > > writer
>>> >>> > > > > > > >>> mentored (which I hope can go directly to
>>> fundraising :-)
>>> >>> > > > > > > >>>
>>> >>> > > > > > > >>> Each project that wants to participate must provide
>>> two
>>> >>> > mentors
>>> >>> > > > for
>>> >>> > > > > > > each
>>> >>> > > > > > > >>> documentation project.
>>> >>> > > > > > > >>>
>>> >>> > > > > > > >>> As part of the application process there are a few
>>> things
>>> >>> > that
>>> >>> > > we
>>> >>> > > > > > need
>>> >>> > > > > > > to
>>> >>> > > > > > > >>> setup.
>>> >>> > > > > > > >>>
>>> >>> > > > > > > >>> 1. Season of Docs Page and List of Project Ideas
>>> >>> > > > > > > >>> We need to create a public webpage about Season of
>>> Docs
>>> >>> that
>>> >>> > > > > contains
>>> >>> > > > > > > the
>>> >>> > > > > > > >>> list of project ideas for documentation. I have
>>> created a
>>> >>> > page
>>> >>> > > on
>>> >>> > > > > the
>>> >>> > > > > > > >>> ComDev wiki https://s.apache.org/w4CH  with a table
>>> for
>>> >>> > > projects
>>> >>> > > > > to
>>> >>> > > > > > > >> record
>>> >>> > > > > > > >>> their ideas.
>>> >>> > > > > > > >>>
>>> >>> > > > > > > >>> 2. Alternative administrator.
>>> >>> > > > > > > >>> I’ve set myself up as the primary admin and Maxim as
>>> the
>>> >>> > > > > alternative
>>> >>> > > > > > > >> admin
>>> >>> > > > > > > >>> (Maxim, I need to confirm your contact email and you
>>> will
>>> >>> > also
>>> >>> > > > need
>>> >>> > > > > > to
>>> >>> > > > > > > >>> register as the alternative admin and I will email
>>> you
>>> >>> the
>>> >>> > link
>>> >>> > > > > > > offline)
>>> >>> > > > > > > >>>
>>> >>> > > > > > > >>> 3. Mentors
>>> >>> > > > > > > >>> All mentors from the projects interested in
>>> participating
>>> >>> > must
>>> >>> > > > > > register
>>> >>> > > > > > > >>> individually at the following link :
>>> >>> > > > > > > https://forms.gle/a1x26WQGzURLerv66
>>> >>> > > > > > > >> .
>>> >>> > > > > > > >>>
>>> >>> > > > > > > >>> 4. Application Form: Documentation / Technnial Writer
>>> >>> > > > Collaboration
>>> >>> > > > > > > >>> There is a section to fill in about experience with
>>> >>> > > documentation
>>> >>> > > > > and
>>> >>> > > > > > > any
>>> >>> > > > > > > >>> previous collaboration with technical writers. I
>>> know a
>>> >>> few
>>> >>> > > > > projects
>>> >>> > > > > > > have
>>> >>> > > > > > > >>> used various tools for documentation - but not sure
>>> >>> about any
>>> >>> > > > > > technical
>>> >>> > > > > > > >>> writing collaboration (so if you know of any then
>>> please
>>> >>> let
>>> >>> > me
>>> >>> > > > > know)
>>> >>> > > > > > > >>>
>>> >>> > > > > > > >>> 5. Application Form: GSoC
>>> >>> > > > > > > >>> There is a section to complete at our participation
>>> in
>>> >>> GSoC.I
>>> >>> > > > > think I
>>> >>> > > > > > > >> have
>>> >>> > > > > > > >>> the details from our application this year so can
>>> follow
>>> >>> up
>>> >>> > > with
>>> >>> > > > > > Maxim
>>> >>> > > > > > > or
>>> >>> > > > > > > >>> Uli about it
>>> >>> > > > > > > >>>
>>> >>> > > > > > > >>> This is all I have at the moment and we have until
>>> the
>>> >>> 23rd
>>> >>> > > April
>>> >>> > > > > > 2019
>>> >>> > > > > > > to
>>> >>> > > > > > > >>> finalise all the application details. Ideally I want
>>> to
>>> >>> have
>>> >>> > it
>>> >>> > > > > done
>>> >>> > > > > > > well
>>> >>> > > > > > > >>> before then :-)
>>> >>> > > > > > > >>>
>>> >>> > > > > > > >>> Please pass on this information within your various
>>> >>> projects
>>> >>> > > and
>>> >>> > > > as
>>> >>> > > > > > > with
>>> >>> > > > > > > >>> GSoC - I'll see how we can get this information out
>>> to
>>> >>> all
>>> >>> > our
>>> >>> > > > > > project
>>> >>> > > > > > > >>> mailing lists.
>>> >>> > > > > > > >>>
>>> >>> > > > > > > >>> Thanks
>>> >>> > > > > > > >>> Sharan
>>> >>> > > > > > > >>>
>>> >>> > > > > > > >>> ==================================================
>>> >>> > > > > > > >>>
>>> >>> > > > > > > >>> I guess, we would need to follow these steps as well.
>>> >>> > > > > > > >>>
>>> >>> > > > > > > >>> Best,
>>> >>> > > > > > > >>> Fabian
>>> >>> > > > > > > >>>
>>> >>> > > > > > > >>> Am Do., 11. Apr. 2019 um 05:08 Uhr schrieb Jark Wu <
>>> >>> > > > > [hidden email]
>>> >>> > > > > > >:
>>> >>> > > > > > > >>>
>>> >>> > > > > > > >>>> Hi Aizhamal,
>>> >>> > > > > > > >>>>
>>> >>> > > > > > > >>>> That's really interesting. We have an ongoing
>>> proposal
>>> >>> for
>>> >>> > > > > > supporting
>>> >>> > > > > > > >>>> Chinese documentation, see FLIP-35 [1].
>>> >>> > > > > > > >>>>
>>> >>> > > > > > > >>>> I think it's a good idea to propose Chinese
>>> translation
>>> >>> as a
>>> >>> > > > > > project.
>>> >>> > > > > > > >>> It's
>>> >>> > > > > > > >>>> a good chance to improve the localization user
>>> >>> experience of
>>> >>> > > > Flink
>>> >>> > > > > > > >>>> documentation.
>>> >>> > > > > > > >>>> I can help as a mentor if we want to submit such a
>>> >>> project.
>>> >>> > > > > > > >>>>
>>> >>> > > > > > > >>>> Thanks,
>>> >>> > > > > > > >>>> Jark Wu
>>> >>> > > > > > > >>>>
>>> >>> > > > > > > >>>> [1]:
>>> >>> > > > > > > >>>>
>>> >>> > > > > > > >>>
>>> >>> > > > > > > >>
>>> >>> > > > > > >
>>> >>> > > > > >
>>> >>> > > > >
>>> >>> > > >
>>> >>> > >
>>> >>> >
>>> >>>
>>> https://cwiki.apache.org/confluence/display/FLINK/FLIP-35%3A+Support+Chinese+Documents+and+Website
>>> >>> > > > > > > >>>>
>>> >>> > > > > > > >>>> On Thu, 11 Apr 2019 at 02:11, Aizhamal Nurmamat kyzy
>>> >>> > > > > > > >>>> <[hidden email]> wrote:
>>> >>> > > > > > > >>>>
>>> >>> > > > > > > >>>>> Hello everyone,
>>> >>> > > > > > > >>>>>
>>> >>> > > > > > > >>>>> @Fabian Hueske <[hidden email]> - SoD setup is
>>> a
>>> >>> little
>>> >>> > > bit
>>> >>> > > > > > > >>> different.
>>> >>> > > > > > > >>>>> The ASF determined that each project would be
>>> allowed
>>> >>> to
>>> >>> > > apply
>>> >>> > > > > > > >>>>> individually[1], rather than applying as a single
>>> large
>>> >>> > > > > > organization.
>>> >>> > > > > > > >>>>>
>>> >>> > > > > > > >>>>> Each project applies as an org, with two organizers
>>> >>> > > > (administers)
>>> >>> > > > > > and
>>> >>> > > > > > > >> at
>>> >>> > > > > > > >>>>> least two mentors. As Konstantin pointed out, one
>>> can
>>> >>> be
>>> >>> > both
>>> >>> > > > an
>>> >>> > > > > > > >>>>> administer
>>> >>> > > > > > > >>>>> and a mentor. You don't need to coordinate with
>>> other
>>> >>> > > projects
>>> >>> > > > or
>>> >>> > > > > > ASF
>>> >>> > > > > > > >> at
>>> >>> > > > > > > >>>>> all. If accepted to the program, you will receive
>>> >>> project
>>> >>> > > > > proposals
>>> >>> > > > > > > >> from
>>> >>> > > > > > > >>>>> tech writers [2]. You will choose one or two
>>> proposals
>>> >>> that
>>> >>> > > you
>>> >>> > > > > > want
>>> >>> > > > > > > >> to
>>> >>> > > > > > > >>>>> mentor[3].
>>> >>> > > > > > > >>>>>
>>> >>> > > > > > > >>>>> @Ken - as for the language, there isn’t any
>>> >>> limitations in
>>> >>> > > that
>>> >>> > > > > > > >> regard,
>>> >>> > > > > > > >>> so
>>> >>> > > > > > > >>>>> work on the Chinese translation for the website is
>>> >>> > definitely
>>> >>> > > > an
>>> >>> > > > > > > >>>>> acceptable
>>> >>> > > > > > > >>>>> project.
>>> >>> > > > > > > >>>>>
>>> >>> > > > > > > >>>>> Thanks,
>>> >>> > > > > > > >>>>>
>>> >>> > > > > > > >>>>> Aizhamal
>>> >>> > > > > > > >>>>>
>>> >>> > > > > > > >>>>>
>>> >>> > > > > > > >>>>> [1]
>>> >>> > > > > > > >>>>>
>>> >>> > > > > > > >>>>>
>>> >>> > > > > > > >>>
>>> >>> > > > > > > >>
>>> >>> > > > > > >
>>> >>> > > > > >
>>> >>> > > > >
>>> >>> > > >
>>> >>> > >
>>> >>> >
>>> >>>
>>> https://lists.apache.org/thread.html/67e1c2e6041cff1e7f198b615407401f032795130e796adfaacf8071@%3Cdev.community.apache.org%3E
>>> >>> > > > > > > >>>>>
>>> >>> > > > > > > >>>>> [2]
>>> https://developers.google.com/season-of-docs/docs/
>>> >>> > > > > > > >>>>>
>>> >>> > > > > > > >>>>> [3]
>>> >>> > > > > > > >>>
>>> >>> > > > > >
>>> >>> > >
>>> >>>
>>> https://developers.google.com/season-of-docs/docs/faq#slot-allocation
>>> >>> > > > > > > >>>>>
>>> >>> > > > > > > >>>>>
>>> >>> > > > > > > >>>>> On Wed, Apr 10, 2019 at 8:32 AM Ken Krugler <
>>> >>> > > > > > > >>> [hidden email]>
>>> >>> > > > > > > >>>>> wrote:
>>> >>> > > > > > > >>>>>
>>> >>> > > > > > > >>>>>> Hi Aizhamal,
>>> >>> > > > > > > >>>>>>
>>> >>> > > > > > > >>>>>> I assume SoD is language-agnostic, so one possible
>>> >>> project
>>> >>> > > > would
>>> >>> > > > > > be
>>> >>> > > > > > > >> to
>>> >>> > > > > > > >>>>> get
>>> >>> > > > > > > >>>>>> a tech writer for the Chinese versions of all of
>>> the
>>> >>> Flink
>>> >>> > > > > > > >>>>> documentation,
>>> >>> > > > > > > >>>>>> yes?
>>> >>> > > > > > > >>>>>>
>>> >>> > > > > > > >>>>>> Regards,
>>> >>> > > > > > > >>>>>>
>>> >>> > > > > > > >>>>>> — Ken
>>> >>> > > > > > > >>>>>>
>>> >>> > > > > > > >>>>>>> On Apr 5, 2019, at 3:43 PM, Aizhamal Nurmamat
>>> kyzy
>>> >>> > > > > > > >>>>>> <[hidden email]> wrote:
>>> >>> > > > > > > >>>>>>>
>>> >>> > > > > > > >>>>>>> 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
>>> >>> > > > > > >
>>> >>> > > > > > > --------------------------
>>> >>> > > > > > > Ken Krugler
>>> >>> > > > > > > [phone]
>>> >>> > > > > > > http://www.scaleunlimited.com
>>> >>> > > > > > > Custom big data solutions & training
>>> >>> > > > > > > Flink, Solr, Hadoop, Cascading & Cassandra
>>> >>> > > > > > >
>>> >>> > > > > > >
>>> >>> > > > > >
>>> >>> > > > >
>>> >>> > > >
>>> >>> > >
>>> >>> >
>>> >>>
>>> >>
>>> >>
>>> >> --
>>> >>
>>> >> Konstantin Knauf | Solutions Architect
>>> >>
>>> >> [phone]
>>> >>
>>> >> <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
>>> >>
>>> >
>>>
>>> --
>>>
>>> Konstantin Knauf | Solutions Architect
>>>
>>> [phone]
>>>
>>> <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
>>>
>>

--

Konstantin Knauf | Solutions Architect

[phone]


Planned Absences: 17.04.2019 - 26.04.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

[Fabian Hueske-2]

Thanks Konstantin!

I registered as a mentor and will have a look at the blog post.

Best, Fabian

Am Mi., 17. Apr. 2019 um 18:14 Uhr schrieb Konstantin Knauf <
[hidden email]>:

> Hi everyone,
>
> a few updates on our application:
>
> 1. As Aizhamal (Thanks!) has suggested I also added the information to
> submit during our application to the Google doc [1] and Fabian added a
> description for the SQL project idea (Thanks!).
>
> 2. I had a quick chat with Fabian offline and we concluded, that the "Flink
> Internals" project might not be good fit for Season of Docs after all,
> because, we think, the amount of mentoring by core developers that would be
> necessary to produce such a documentation could not be guaranteed. Any
> opinions?
>
> 3. To submit our application, we need to publish our project ideas list.
> For this I have just opened a PR to add a small blog post about Season of
> Docs [2]. Please have a look and provide feedback.
>
> 4. For mentors (Stephan, Fabian, Jark, David) please complete the mentor
> registration [3] by next Tuesday (*Application Deadline*)
>
> Cheers,
>
> Konstantin
>
> [1]
>
> https://docs.google.com/document/d/1Up53jNsLztApn-mP76AB6xWUVGt3nwS9p6xQTiceKXo/edit?usp=sharing
> [2] https://github.com/apache/flink-web/pull/202
> [3]
>
> https://docs.google.com/forms/d/e/1FAIpQLSe-JjGvaKKGWZOXxrorONhB8qN3mjPrB9ZVkcsntR73Cv_K7g/viewform
>
> On Mon, Apr 15, 2019 at 9:12 PM Aizhamal Nurmamat kyzy <
> [hidden email]>
> wrote:
>
> > +Konstantin Knauf <[hidden email]> this is looking good,
> thanks
> > for sharing!
> >
> > I also created a similar doc for Apache Airflow [1]. It is a bit messy,
> > but it has questions from the application form that you can work with.
> >
> > Cheers,
> > Aizhamal
> >
> > [1]
> >
> https://docs.google.com/document/d/1HoL_yjNYiTAP9IxSlhx3EUnPFU4l9WOT9EnwBZjCZo0/edit#
> >
> >
> > On Mon, Apr 15, 2019 at 2:24 AM Robert Metzger <[hidden email]>
> > wrote:
> >
> >> Hi all,
> >> I'm very happy to see this project happening!
> >>
> >> Thank you for the proposal Konstantin! One idea for the "related
> >> material": we could also link to talks or blog posts about concepts /
> >> monitoring / operations. Potential writers could feel overwhelmed by our
> >> demand for improvements, without any additional material.
> >>
> >>
> >> On Mon, Apr 15, 2019 at 10:16 AM Konstantin Knauf <
> >> [hidden email]> wrote:
> >>
> >>> Hi everyone,
> >>>
> >>> thanks @Aizhamal Nurmamat kyzy <[hidden email]>. As we only have
> >>> one
> >>> week left until the application deadline, I went ahead and created a
> >>> document for the project ideas [1]. I have added the description for
> the
> >>> "stream processing concepts" as well as the "deployment & operations
> >>> documentation" project idea. Please let me know what you think, edit &
> >>> comment. We also need descriptions for the other two projects (Table
> >>> API/SQL & Flink Internals). @Fabian/@Jark/@Stephan can you chime in?
> >>>
> >>> Any more project ideas?
> >>>
> >>> Best,
> >>>
> >>> Konstantin
> >>>
> >>>
> >>> [1]
> >>>
> >>>
> https://docs.google.com/document/d/1Up53jNsLztApn-mP76AB6xWUVGt3nwS9p6xQTiceKXo/edit?usp=sharing
> >>>
> >>>
> >>>
> >>> On Fri, Apr 12, 2019 at 6:50 PM Aizhamal Nurmamat kyzy <
> >>> [hidden email]>
> >>> wrote:
> >>>
> >>> > Hello everyone,
> >>> >
> >>> > @Konstantin Knauf <[hidden email]> - yes, you are correct.
> >>> > Between steps 1 and 2 though, the open source organization, in this
> >>> case
> >>> > Flink, has to be selected by SoD as one of the participating orgs
> >>> *fingers
> >>> > crossed*.
> >>> >
> >>> > One tip about organizing ideas is that you want to communicate
> >>> potential
> >>> > projects to the tech writers that are applying. Just make sure the
> >>> scope of
> >>> > the project is clear to them. The SoD wants to set up the tech
> writers
> >>> for
> >>> > success by making sure the work can be done in the allotted time.
> >>> >
> >>> > Hope it helps.
> >>> >
> >>> > Aizhamal
> >>> >
> >>> >
> >>> >
> >>> > On Fri, Apr 12, 2019 at 7:37 AM Konstantin Knauf <
> >>> [hidden email]>
> >>> > wrote:
> >>> >
> >>> >> Hi all,
> >>> >>
> >>> >> I read through the SoD documentation again, and now I think, it
> would
> >>> >> actually make sense to split (1) up into multiple project ideas. Let
> >>> me
> >>> >> summarize the overall process:
> >>> >>
> >>> >> 1. We create & publish a list of project ideas, e.g. in a blog post.
> >>> >> (This can be any number of ideas.)
> >>> >> 2. Potential technical writers look at our list of ideas and sent a
> >>> >> proposal for a particular project to Google. During that time they
> can
> >>> >> reach out to us for clarification.
> >>> >> 3. Google forwards all proposals for our project ideas to us and we
> >>> sent
> >>> >> back a prioritized list of proposals, which we would like to accept.
> >>> >> 4. Of all these proposals, Google accepts 50 proposals for SoD 2019.
> >>> Per
> >>> >> organization Google will only accept a maximum of two proposals.
> >>> >>
> >>> >> @Aizhamal Nurmamat kyzy <[hidden email]> Please correct me!
> >>> >>
> >>> >> For me this means we should splits this up in a way, that each
> >>> project is
> >>> >> a) still relevant in September b) makes sense as a 3 month project.
> >>> Based
> >>> >> on the ideas we have right now these could for example be:
> >>> >>
> >>> >> (I) Rework/Extract/Improve the documentation of stream processing
> >>> concepts
> >>> >> (II) Improve & extend Apache Flink's documentation for deployment,
> >>> >> operations (incl. configuration)
> >>> >> (III) Add documentation for Flink internals
> >>> >> (IV) Rework Table API / SQL documentation
> >>> >>
> >>> >> We would then get proposals potentially for all of these topics and
> >>> could
> >>> >> decide which of these proposals, we would sent back to Google. My
> >>> feeling
> >>> >> is that a technical writer could easily spent three months on any of
> >>> these
> >>> >> projects. What do others think? Any other project ideas?
> >>> >>
> >>> >> Cheers,
> >>> >>
> >>> >> Konstantin
> >>> >>
> >>> >>
> >>> >>
> >>> >>
> >>> >> On Fri, Apr 12, 2019 at 1:47 PM Jark Wu <[hidden email]> wrote:
> >>> >>
> >>> >>> Hi all,
> >>> >>>
> >>> >>> I'm fine with only preparing the first proposal. I think it's
> >>> reasonable
> >>> >>> because the first proposal is more attractive
> >>> >>> and maybe there is not enough Chinese writer. We can focus on one
> >>> project
> >>> >>> to come up with a concrete and
> >>> >>> attractive project plan.
> >>> >>>
> >>> >>> One possible subproject could be rework Table SQL docs.
> >>> >>> (1). Improve concepts in Table SQL.
> >>> >>> (2). A more detailed introduction of built-in functions, currently
> we
> >>> >>> only
> >>> >>> have a simple explanation for each function.
> >>> >>>       We should add more descriptions, especially more concrete
> >>> examples,
> >>> >>> and maybe some notes. We can take
> >>> >>>       MySQL doc [1] as a reference.
> >>> >>> (3). As Flink SQL is evolving rapidly and features from Blink is
> >>> being
> >>> >>> merged,  for example, SQL DDL, Hive integration,
> >>> >>>       Python Table API, Interactive Programing, SQL optimization
> and
> >>> >>> tuning, etc... We can redesign the doc structure of
> >>> >>>       Table SQL in a higher vision.
> >>> >>>
> >>> >>> Cheers,
> >>> >>> Jark
> >>> >>>
> >>> >>> [1]:
> >>> >>>
> >>> >>>
> >>>
> https://dev.mysql.com/doc/refman/5.7/en/string-functions.html#function_bin
> >>> >>>
> >>> >>>
> >>> >>>
> >>> >>> On Fri, 12 Apr 2019 at 18:19, jincheng sun <
> [hidden email]
> >>> >
> >>> >>> wrote:
> >>> >>>
> >>> >>> > I am honored to have the opportunity to do a second organization
> >>> >>> > administrator‘s works!
> >>> >>> >
> >>> >>> > It seems that one project and multiple projects have their own
> >>> >>> advantages.
> >>> >>> >
> >>> >>> > My understanding is that even if we only have one project, we
> also
> >>> can
> >>> >>> have
> >>> >>> > multiple mentors and recruit enough writers.
> >>> >>> >
> >>> >>> > Fabian Hueske <[hidden email]> 于2019年4月12日周五 下午5:57写道：
> >>> >>> >
> >>> >>> > > Yes, I think we would get at most one project accepted.
> >>> >>> > > Having all options in a rather generic proposal gives us the
> most
> >>> >>> > > flexibility to decide what to work on once the proposal is
> >>> accepted.
> >>> >>> > > On the other hand, a more concrete proposal might look more
> >>> >>> attractive
> >>> >>> > for
> >>> >>> > > candidates.
> >>> >>> > > I'm fine either way, but my gut feeling is that a well scoped
> >>> >>> proposal
> >>> >>> > > gives better changes of finding a writer (which might be the
> >>> biggest
> >>> >>> > > challenge).
> >>> >>> > >
> >>> >>> > > Am Fr., 12. Apr. 2019 um 11:39 Uhr schrieb Stephan Ewen <
> >>> >>> > [hidden email]
> >>> >>> > > >:
> >>> >>> > >
> >>> >>> > > > I would suggest to make one proposal and have the subsections
> >>> only
> >>> >>> in
> >>> >>> > the
> >>> >>> > > > project plan.
> >>> >>> > > > My understanding is that we need to indicate priorities
> between
> >>> >>> > proposals
> >>> >>> > > > and might get only one, so it would be good to not subdivide.
> >>> >>> > > >
> >>> >>> > > > On Fri, Apr 12, 2019 at 9:58 AM Fabian Hueske <
> >>> [hidden email]>
> >>> >>> > wrote:
> >>> >>> > > >
> >>> >>> > > > > Hi everyone,
> >>> >>> > > > >
> >>> >>> > > > > I think we can split the first project that Stephan
> proposed
> >>> into
> >>> >>> > > smaller
> >>> >>> > > > > ones:
> >>> >>> > > > >
> >>> >>> > > > > > (1) Create or rework setup / tutorials / concepts docs
> >>> >>> > > > > > (2) Complete (or advance) the Chinese translation
> >>> >>> > > > >
> >>> >>> > > > > 1.1 Improving (extracting) the documentation of stream
> >>> processing
> >>> >>> > > > concepts:
> >>> >>> > > > > Event-time, Timers, State, State Backends, Checkpointing,
> >>> >>> Savepoints
> >>> >>> > > > > Right now, the relevant information is scattered across
> >>> several
> >>> >>> pages
> >>> >>> > > and
> >>> >>> > > > > mixed with the implementation / APIs / configuration
> options.
> >>> >>> > > > >
> >>> >>> > > > > 1.2 Improving & extending the documentation of deployments
> >>> >>> > > > >
> >>> >>> > > > > 1.3 Adding documentation in the internals: Distributed
> >>> >>> architecture,
> >>> >>> > > > > recovery, operators, job translation, execution, etc.
> >>> >>> > > > > This documentation would be targeted to Flink developers.
> >>> >>> > > > >
> >>> >>> > > > > I thought again about the idea of improving the tutorials,
> >>> and
> >>> >>> I'm no
> >>> >>> > > > > longer sure if this would fit SoD well.
> >>> >>> > > > > The reason is that creating good tutorials requires a good
> >>> >>> portion of
> >>> >>> > > > > coding / configuration (creating Docker images, example
> >>> programs,
> >>> >>> > > etc.).
> >>> >>> > > > > Also I'd like to start improving the situation of tutorials
> >>> >>> earlier
> >>> >>> > > than
> >>> >>> > > > > September.
> >>> >>> > > > >
> >>> >>> > > > > What do others think?
> >>> >>> > > > >
> >>> >>> > > > > Cheers, Fabian
> >>> >>> > > > >
> >>> >>> > > > >
> >>> >>> > > > > Am Fr., 12. Apr. 2019 um 04:29 Uhr schrieb Jark Wu <
> >>> >>> [hidden email]
> >>> >>> > >:
> >>> >>> > > > >
> >>> >>> > > > > > Hi Konstantin, Ken,
> >>> >>> > > > > >
> >>> >>> > > > > > I agree that Chinese documentation is mainly a
> translation.
> >>> >>> > > > > >
> >>> >>> > > > > > >  Does anyone from the Blink team have input on whether
> >>> there
> >>> >>> is
> >>> >>> > > > > existing,
> >>> >>> > > > > > original Chinese documentation which should be translated
> >>> to
> >>> >>> > English?
> >>> >>> > > > > >
> >>> >>> > > > > > There is a public Blink documentation [1] which is
> English.
> >>> >>> > > > > > We have a Blink Chinese documentation in internal, but I
> >>> think
> >>> >>> we
> >>> >>> > > need
> >>> >>> > > > to
> >>> >>> > > > > > rewrite it in English and restructure it when
> contributing
> >>> >>> Blink to
> >>> >>> > > > > Flink.
> >>> >>> > > > > >
> >>> >>> > > > > > Regarding the Chinese translation project, I agree with
> >>> Ken's
> >>> >>> > > opinion.
> >>> >>> > > > > >
> >>> >>> > > > > > From the point of my translation experience, translation
> >>> is a
> >>> >>> work
> >>> >>> > > that
> >>> >>> > > > > > need to understand the original English sentence
> correctly
> >>> and
> >>> >>> then
> >>> >>> > > > > express
> >>> >>> > > > > > it in Chinese in an easily understandable way. This is
> not
> >>> a
> >>> >>> simple
> >>> >>> > > > work
> >>> >>> > > > > > that translate word by word. The one we need is not a
> >>> >>> "professional
> >>> >>> > > > > > translator",
> >>> >>> > > > > > but a "technical writer who are familiar with both
> >>> >>> languages".  I
> >>> >>> > > also
> >>> >>> > > > > > agree that the writer who write the initial documentation
> >>> has
> >>> >>> the
> >>> >>> > > > better
> >>> >>> > > > > > ability than
> >>> >>> > > > > > translator to distill complex technical concepts.
> >>> >>> > > > > >
> >>> >>> > > > > > [1]: https://flink-china.org/doc/blink
> >>> >>> > > > > >
> >>> >>> > > > > > On Fri, 12 Apr 2019 at 02:40, Ken Krugler <
> >>> >>> > > [hidden email]
> >>> >>> > > > >
> >>> >>> > > > > > wrote:
> >>> >>> > > > > >
> >>> >>> > > > > > > Hi Konstantin,
> >>> >>> > > > > > >
> >>> >>> > > > > > > Comments inline below…
> >>> >>> > > > > > >
> >>> >>> > > > > > > — Ken
> >>> >>> > > > > > >
> >>> >>> > > > > > > > On Apr 11, 2019, at 9:05 AM, Konstantin Knauf <
> >>> >>> > > > > > [hidden email]>
> >>> >>> > > > > > > wrote:
> >>> >>> > > > > > > >
> >>> >>> > > > > > > > Hi everyone,
> >>> >>> > > > > > > >
> >>> >>> > > > > > > > I will start going through the registration process
> >>> >>> tomorrow
> >>> >>> > > (CET).
> >>> >>> > > > > > > > Jincheng (cc) reached out to me directly and offered
> >>> to be
> >>> >>> the
> >>> >>> > > > second
> >>> >>> > > > > > > > organization administrator. So, we are all set in
> that
> >>> >>> regard.
> >>> >>> > > > > > > >
> >>> >>> > > > > > > > In terms of mentors, we now have
> >>> >>> > > > > > > >
> >>> >>> > > > > > > > * myself
> >>> >>> > > > > > > > * Fabian
> >>> >>> > > > > > > > * David
> >>> >>> > > > > > > > * Stephan
> >>> >>> > > > > > > > * Jark (Chinese Translation)
> >>> >>> > > > > > > >
> >>> >>> > > > > > > > Regarding the Chinese translation project, it is
> >>> probably a
> >>> >>> > > > question
> >>> >>> > > > > of
> >>> >>> > > > > > > how
> >>> >>> > > > > > > > independent the Chinese version is supposed to be. If
> >>> the
> >>> >>> > English
> >>> >>> > > > > > > > documentation is the ground-truth and the Chinese
> >>> >>> documentation
> >>> >>> > > is
> >>> >>> > > > > > > (mainly)
> >>> >>> > > > > > > > a translation, I agree with Stefan. If the Chinese
> >>> >>> > documentation
> >>> >>> > > is
> >>> >>> > > > > > > > supposed to become an independent secondary
> >>> documentation,
> >>> >>> it
> >>> >>> > > could
> >>> >>> > > > > be
> >>> >>> > > > > > a
> >>> >>> > > > > > > > project for a technical writer as well. Has this
> >>> questions
> >>> >>> > > already
> >>> >>> > > > > been
> >>> >>> > > > > > > > discussed in the community?
> >>> >>> > > > > > >
> >>> >>> > > > > > > My understanding is that the Chinese documentation is
> >>> going
> >>> >>> to
> >>> >>> > > mostly
> >>> >>> > > > > be
> >>> >>> > > > > > a
> >>> >>> > > > > > > translation of the English versions.
> >>> >>> > > > > > >
> >>> >>> > > > > > > Though perhaps, with all of the Blink integration going
> >>> on,
> >>> >>> the
> >>> >>> > > > inverse
> >>> >>> > > > > > > could also be true.
> >>> >>> > > > > > >
> >>> >>> > > > > > > Does anyone from the Blink team have input on whether
> >>> there
> >>> >>> is
> >>> >>> > > > > existing,
> >>> >>> > > > > > > original Chinese documentation which should be
> >>> translated to
> >>> >>> > > English?
> >>> >>> > > > > > >
> >>> >>> > > > > > > > On Thu, Apr 11, 2019 at 11:34 AM Stephan Ewen <
> >>> >>> > [hidden email]>
> >>> >>> > > > > > wrote:
> >>> >>> > > > > > > >
> >>> >>> > > > > > > >> So we have two ideas for docs projects now:
> >>> >>> > > > > > > >>
> >>> >>> > > > > > > >> (1) Create or rework setup / tutorials / concepts
> docs
> >>> >>> > > > > > > >> (2) Complete (or advance) the Chinese translation
> >>> >>> > > > > > > >>
> >>> >>> > > > > > > >> Should we apply for both (and let the SoD committee
> >>> select
> >>> >>> > > > whichever
> >>> >>> > > > > > > they
> >>> >>> > > > > > > >> want to sponsor) or select one of them?
> >>> >>> > > > > > > >>
> >>> >>> > > > > > > >> For project (2), this sounds to me more like a
> project
> >>> >>> for a
> >>> >>> > > > > > > "translator",
> >>> >>> > > > > > > >> not a "technical writer". As far as I understand it,
> >>> the
> >>> >>> big
> >>> >>> > > > benefit
> >>> >>> > > > > > of
> >>> >>> > > > > > > >> having a technical writer is to have someone who can
> >>> >>> describe
> >>> >>> > > > > > > complicated
> >>> >>> > > > > > > >> technical concepts (that engineers describe in
> >>> complicated
> >>> >>> > > > language)
> >>> >>> > > > > > in
> >>> >>> > > > > > > an
> >>> >>> > > > > > > >> easily understandable way.
> >>> >>> > > > > > >
> >>> >>> > > > > > > Actually a good Chinese translation of the technical
> docs
> >>> >>> > requires
> >>> >>> > > > > > someone
> >>> >>> > > > > > > with many of the same skills. In order for the
> >>> translation
> >>> >>> to be
> >>> >>> > > > > > accurate,
> >>> >>> > > > > > > you need someone who understands the concepts of the
> >>> >>> underlying
> >>> >>> > > > > > technology,
> >>> >>> > > > > > > to use appropriate terminology. Though I agree that the
> >>> >>> ability
> >>> >>> > to
> >>> >>> > > > > > distill
> >>> >>> > > > > > > complex technical concepts is more important when
> writing
> >>> >>> initial
> >>> >>> > > > > > > documentation.
> >>> >>> > > > > > >
> >>> >>> > > > > > >
> >>> >>> > > > > > > >> On Thu, Apr 11, 2019 at 9:47 AM Fabian Hueske <
> >>> >>> > > [hidden email]>
> >>> >>> > > > > > > wrote:
> >>> >>> > > > > > > >>
> >>> >>> > > > > > > >>> Thanks for the clarification Aizhamal!
> >>> >>> > > > > > > >>> This is really helpful and will make it a lot
> easier
> >>> to
> >>> >>> > > > coordinate
> >>> >>> > > > > > :-)
> >>> >>> > > > > > > >>>
> >>> >>> > > > > > > >>> As for next steps, I found this email on the
> >>> >>> > > > > > [hidden email]
> >>> >>> > > > > > > >>> mailing list:
> >>> >>> > > > > > > >>>
> >>> >>> > > > > > > >>> ==================================================
> >>> >>> > > > > > > >>> Hi All,
> >>> >>> > > > > > > >>>
> >>> >>> > > > > > > >>> As mentioned the applications for the Google Season
> >>> of
> >>> >>> Docs
> >>> >>> > > > opened
> >>> >>> > > > > > > today
> >>> >>> > > > > > > >>> and I'm working my way through it on behalf of the
> >>> ASF.
> >>> >>> > > > > > > >>>
> >>> >>> > > > > > > >>> If accepted, we will be allocated either one or two
> >>> >>> techical
> >>> >>> > > > > writers.
> >>> >>> > > > > > > >>> Google will also pay the ASF a stipend of $500 per
> >>> >>> technical
> >>> >>> > > > writer
> >>> >>> > > > > > > >>> mentored (which I hope can go directly to
> >>> fundraising :-)
> >>> >>> > > > > > > >>>
> >>> >>> > > > > > > >>> Each project that wants to participate must provide
> >>> two
> >>> >>> > mentors
> >>> >>> > > > for
> >>> >>> > > > > > > each
> >>> >>> > > > > > > >>> documentation project.
> >>> >>> > > > > > > >>>
> >>> >>> > > > > > > >>> As part of the application process there are a few
> >>> things
> >>> >>> > that
> >>> >>> > > we
> >>> >>> > > > > > need
> >>> >>> > > > > > > to
> >>> >>> > > > > > > >>> setup.
> >>> >>> > > > > > > >>>
> >>> >>> > > > > > > >>> 1. Season of Docs Page and List of Project Ideas
> >>> >>> > > > > > > >>> We need to create a public webpage about Season of
> >>> Docs
> >>> >>> that
> >>> >>> > > > > contains
> >>> >>> > > > > > > the
> >>> >>> > > > > > > >>> list of project ideas for documentation. I have
> >>> created a
> >>> >>> > page
> >>> >>> > > on
> >>> >>> > > > > the
> >>> >>> > > > > > > >>> ComDev wiki https://s.apache.org/w4CH  with a
> table
> >>> for
> >>> >>> > > projects
> >>> >>> > > > > to
> >>> >>> > > > > > > >> record
> >>> >>> > > > > > > >>> their ideas.
> >>> >>> > > > > > > >>>
> >>> >>> > > > > > > >>> 2. Alternative administrator.
> >>> >>> > > > > > > >>> I’ve set myself up as the primary admin and Maxim
> as
> >>> the
> >>> >>> > > > > alternative
> >>> >>> > > > > > > >> admin
> >>> >>> > > > > > > >>> (Maxim, I need to confirm your contact email and
> you
> >>> will
> >>> >>> > also
> >>> >>> > > > need
> >>> >>> > > > > > to
> >>> >>> > > > > > > >>> register as the alternative admin and I will email
> >>> you
> >>> >>> the
> >>> >>> > link
> >>> >>> > > > > > > offline)
> >>> >>> > > > > > > >>>
> >>> >>> > > > > > > >>> 3. Mentors
> >>> >>> > > > > > > >>> All mentors from the projects interested in
> >>> participating
> >>> >>> > must
> >>> >>> > > > > > register
> >>> >>> > > > > > > >>> individually at the following link :
> >>> >>> > > > > > > https://forms.gle/a1x26WQGzURLerv66
> >>> >>> > > > > > > >> .
> >>> >>> > > > > > > >>>
> >>> >>> > > > > > > >>> 4. Application Form: Documentation / Technnial
> Writer
> >>> >>> > > > Collaboration
> >>> >>> > > > > > > >>> There is a section to fill in about experience with
> >>> >>> > > documentation
> >>> >>> > > > > and
> >>> >>> > > > > > > any
> >>> >>> > > > > > > >>> previous collaboration with technical writers. I
> >>> know a
> >>> >>> few
> >>> >>> > > > > projects
> >>> >>> > > > > > > have
> >>> >>> > > > > > > >>> used various tools for documentation - but not sure
> >>> >>> about any
> >>> >>> > > > > > technical
> >>> >>> > > > > > > >>> writing collaboration (so if you know of any then
> >>> please
> >>> >>> let
> >>> >>> > me
> >>> >>> > > > > know)
> >>> >>> > > > > > > >>>
> >>> >>> > > > > > > >>> 5. Application Form: GSoC
> >>> >>> > > > > > > >>> There is a section to complete at our participation
> >>> in
> >>> >>> GSoC.I
> >>> >>> > > > > think I
> >>> >>> > > > > > > >> have
> >>> >>> > > > > > > >>> the details from our application this year so can
> >>> follow
> >>> >>> up
> >>> >>> > > with
> >>> >>> > > > > > Maxim
> >>> >>> > > > > > > or
> >>> >>> > > > > > > >>> Uli about it
> >>> >>> > > > > > > >>>
> >>> >>> > > > > > > >>> This is all I have at the moment and we have until
> >>> the
> >>> >>> 23rd
> >>> >>> > > April
> >>> >>> > > > > > 2019
> >>> >>> > > > > > > to
> >>> >>> > > > > > > >>> finalise all the application details. Ideally I
> want
> >>> to
> >>> >>> have
> >>> >>> > it
> >>> >>> > > > > done
> >>> >>> > > > > > > well
> >>> >>> > > > > > > >>> before then :-)
> >>> >>> > > > > > > >>>
> >>> >>> > > > > > > >>> Please pass on this information within your various
> >>> >>> projects
> >>> >>> > > and
> >>> >>> > > > as
> >>> >>> > > > > > > with
> >>> >>> > > > > > > >>> GSoC - I'll see how we can get this information out
> >>> to
> >>> >>> all
> >>> >>> > our
> >>> >>> > > > > > project
> >>> >>> > > > > > > >>> mailing lists.
> >>> >>> > > > > > > >>>
> >>> >>> > > > > > > >>> Thanks
> >>> >>> > > > > > > >>> Sharan
> >>> >>> > > > > > > >>>
> >>> >>> > > > > > > >>> ==================================================
> >>> >>> > > > > > > >>>
> >>> >>> > > > > > > >>> I guess, we would need to follow these steps as
> well.
> >>> >>> > > > > > > >>>
> >>> >>> > > > > > > >>> Best,
> >>> >>> > > > > > > >>> Fabian
> >>> >>> > > > > > > >>>
> >>> >>> > > > > > > >>> Am Do., 11. Apr. 2019 um 05:08 Uhr schrieb Jark Wu
> <
> >>> >>> > > > > [hidden email]
> >>> >>> > > > > > >:
> >>> >>> > > > > > > >>>
> >>> >>> > > > > > > >>>> Hi Aizhamal,
> >>> >>> > > > > > > >>>>
> >>> >>> > > > > > > >>>> That's really interesting. We have an ongoing
> >>> proposal
> >>> >>> for
> >>> >>> > > > > > supporting
> >>> >>> > > > > > > >>>> Chinese documentation, see FLIP-35 [1].
> >>> >>> > > > > > > >>>>
> >>> >>> > > > > > > >>>> I think it's a good idea to propose Chinese
> >>> translation
> >>> >>> as a
> >>> >>> > > > > > project.
> >>> >>> > > > > > > >>> It's
> >>> >>> > > > > > > >>>> a good chance to improve the localization user
> >>> >>> experience of
> >>> >>> > > > Flink
> >>> >>> > > > > > > >>>> documentation.
> >>> >>> > > > > > > >>>> I can help as a mentor if we want to submit such a
> >>> >>> project.
> >>> >>> > > > > > > >>>>
> >>> >>> > > > > > > >>>> Thanks,
> >>> >>> > > > > > > >>>> Jark Wu
> >>> >>> > > > > > > >>>>
> >>> >>> > > > > > > >>>> [1]:
> >>> >>> > > > > > > >>>>
> >>> >>> > > > > > > >>>
> >>> >>> > > > > > > >>
> >>> >>> > > > > > >
> >>> >>> > > > > >
> >>> >>> > > > >
> >>> >>> > > >
> >>> >>> > >
> >>> >>> >
> >>> >>>
> >>>
> https://cwiki.apache.org/confluence/display/FLINK/FLIP-35%3A+Support+Chinese+Documents+and+Website
> >>> >>> > > > > > > >>>>
> >>> >>> > > > > > > >>>> On Thu, 11 Apr 2019 at 02:11, Aizhamal Nurmamat
> kyzy
> >>> >>> > > > > > > >>>> <[hidden email]> wrote:
> >>> >>> > > > > > > >>>>
> >>> >>> > > > > > > >>>>> Hello everyone,
> >>> >>> > > > > > > >>>>>
> >>> >>> > > > > > > >>>>> @Fabian Hueske <[hidden email]> - SoD setup
> is
> >>> a
> >>> >>> little
> >>> >>> > > bit
> >>> >>> > > > > > > >>> different.
> >>> >>> > > > > > > >>>>> The ASF determined that each project would be
> >>> allowed
> >>> >>> to
> >>> >>> > > apply
> >>> >>> > > > > > > >>>>> individually[1], rather than applying as a single
> >>> large
> >>> >>> > > > > > organization.
> >>> >>> > > > > > > >>>>>
> >>> >>> > > > > > > >>>>> Each project applies as an org, with two
> organizers
> >>> >>> > > > (administers)
> >>> >>> > > > > > and
> >>> >>> > > > > > > >> at
> >>> >>> > > > > > > >>>>> least two mentors. As Konstantin pointed out, one
> >>> can
> >>> >>> be
> >>> >>> > both
> >>> >>> > > > an
> >>> >>> > > > > > > >>>>> administer
> >>> >>> > > > > > > >>>>> and a mentor. You don't need to coordinate with
> >>> other
> >>> >>> > > projects
> >>> >>> > > > or
> >>> >>> > > > > > ASF
> >>> >>> > > > > > > >> at
> >>> >>> > > > > > > >>>>> all. If accepted to the program, you will receive
> >>> >>> project
> >>> >>> > > > > proposals
> >>> >>> > > > > > > >> from
> >>> >>> > > > > > > >>>>> tech writers [2]. You will choose one or two
> >>> proposals
> >>> >>> that
> >>> >>> > > you
> >>> >>> > > > > > want
> >>> >>> > > > > > > >> to
> >>> >>> > > > > > > >>>>> mentor[3].
> >>> >>> > > > > > > >>>>>
> >>> >>> > > > > > > >>>>> @Ken - as for the language, there isn’t any
> >>> >>> limitations in
> >>> >>> > > that
> >>> >>> > > > > > > >> regard,
> >>> >>> > > > > > > >>> so
> >>> >>> > > > > > > >>>>> work on the Chinese translation for the website
> is
> >>> >>> > definitely
> >>> >>> > > > an
> >>> >>> > > > > > > >>>>> acceptable
> >>> >>> > > > > > > >>>>> project.
> >>> >>> > > > > > > >>>>>
> >>> >>> > > > > > > >>>>> Thanks,
> >>> >>> > > > > > > >>>>>
> >>> >>> > > > > > > >>>>> Aizhamal
> >>> >>> > > > > > > >>>>>
> >>> >>> > > > > > > >>>>>
> >>> >>> > > > > > > >>>>> [1]
> >>> >>> > > > > > > >>>>>
> >>> >>> > > > > > > >>>>>
> >>> >>> > > > > > > >>>
> >>> >>> > > > > > > >>
> >>> >>> > > > > > >
> >>> >>> > > > > >
> >>> >>> > > > >
> >>> >>> > > >
> >>> >>> > >
> >>> >>> >
> >>> >>>
> >>>
> https://lists.apache.org/thread.html/67e1c2e6041cff1e7f198b615407401f032795130e796adfaacf8071@%3Cdev.community.apache.org%3E
> >>> >>> > > > > > > >>>>>
> >>> >>> > > > > > > >>>>> [2]
> >>> https://developers.google.com/season-of-docs/docs/
> >>> >>> > > > > > > >>>>>
> >>> >>> > > > > > > >>>>> [3]
> >>> >>> > > > > > > >>>
> >>> >>> > > > > >
> >>> >>> > >
> >>> >>>
> >>> https://developers.google.com/season-of-docs/docs/faq#slot-allocation
> >>> >>> > > > > > > >>>>>
> >>> >>> > > > > > > >>>>>
> >>> >>> > > > > > > >>>>> On Wed, Apr 10, 2019 at 8:32 AM Ken Krugler <
> >>> >>> > > > > > > >>> [hidden email]>
> >>> >>> > > > > > > >>>>> wrote:
> >>> >>> > > > > > > >>>>>
> >>> >>> > > > > > > >>>>>> Hi Aizhamal,
> >>> >>> > > > > > > >>>>>>
> >>> >>> > > > > > > >>>>>> I assume SoD is language-agnostic, so one
> possible
> >>> >>> project
> >>> >>> > > > would
> >>> >>> > > > > > be
> >>> >>> > > > > > > >> to
> >>> >>> > > > > > > >>>>> get
> >>> >>> > > > > > > >>>>>> a tech writer for the Chinese versions of all of
> >>> the
> >>> >>> Flink
> >>> >>> > > > > > > >>>>> documentation,
> >>> >>> > > > > > > >>>>>> yes?
> >>> >>> > > > > > > >>>>>>
> >>> >>> > > > > > > >>>>>> Regards,
> >>> >>> > > > > > > >>>>>>
> >>> >>> > > > > > > >>>>>> — Ken
> >>> >>> > > > > > > >>>>>>
> >>> >>> > > > > > > >>>>>>> On Apr 5, 2019, at 3:43 PM, Aizhamal Nurmamat
> >>> kyzy
> >>> >>> > > > > > > >>>>>> <[hidden email]> wrote:
> >>> >>> > > > > > > >>>>>>>
> >>> >>> > > > > > > >>>>>>> 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
> >>> >>> > > > > > >
> >>> >>> > > > > > > --------------------------
> >>> >>> > > > > > > Ken Krugler
> >>> >>> > > > > > > [phone]
> >>> >>> > > > > > > http://www.scaleunlimited.com
> >>> >>> > > > > > > Custom big data solutions & training
> >>> >>> > > > > > > Flink, Solr, Hadoop, Cascading & Cassandra
> >>> >>> > > > > > >
> >>> >>> > > > > > >
> >>> >>> > > > > >
> >>> >>> > > > >
> >>> >>> > > >
> >>> >>> > >
> >>> >>> >
> >>> >>>
> >>> >>
> >>> >>
> >>> >> --
> >>> >>
> >>> >> Konstantin Knauf | Solutions Architect
> >>> >>
> >>> >> [phone]
> >>> >>
> >>> >> <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
> >>> >>
> >>> >
> >>>
> >>> --
> >>>
> >>> Konstantin Knauf | Solutions Architect
> >>>
> >>> [phone]
> >>>
> >>> <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
> >>>
> >>
>
> --
>
> Konstantin Knauf | Solutions Architect
>
> [phone]
>
>
> Planned Absences: 17.04.2019 - 26.04.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
>

[Jark Wu-2]

Thanks Konstantin!

I registered as a mentor and have left comments on the blog pull request.

Regards,
Jark


On Thu, 18 Apr 2019 at 00:36, Fabian Hueske <[hidden email]> wrote:

> Thanks Konstantin!
>
> I registered as a mentor and will have a look at the blog post.
>
> Best, Fabian
>
> Am Mi., 17. Apr. 2019 um 18:14 Uhr schrieb Konstantin Knauf <
> [hidden email]>:
>
>> Hi everyone,
>>
>> a few updates on our application:
>>
>> 1. As Aizhamal (Thanks!) has suggested I also added the information to
>> submit during our application to the Google doc [1] and Fabian added a
>> description for the SQL project idea (Thanks!).
>>
>> 2. I had a quick chat with Fabian offline and we concluded, that the
>> "Flink
>> Internals" project might not be good fit for Season of Docs after all,
>> because, we think, the amount of mentoring by core developers that would
>> be
>> necessary to produce such a documentation could not be guaranteed. Any
>> opinions?
>>
>> 3. To submit our application, we need to publish our project ideas list.
>> For this I have just opened a PR to add a small blog post about Season of
>> Docs [2]. Please have a look and provide feedback.
>>
>> 4. For mentors (Stephan, Fabian, Jark, David) please complete the mentor
>> registration [3] by next Tuesday (*Application Deadline*)
>>
>> Cheers,
>>
>> Konstantin
>>
>> [1]
>>
>> https://docs.google.com/document/d/1Up53jNsLztApn-mP76AB6xWUVGt3nwS9p6xQTiceKXo/edit?usp=sharing
>> [2] https://github.com/apache/flink-web/pull/202
>> [3]
>>
>> https://docs.google.com/forms/d/e/1FAIpQLSe-JjGvaKKGWZOXxrorONhB8qN3mjPrB9ZVkcsntR73Cv_K7g/viewform
>>
>> On Mon, Apr 15, 2019 at 9:12 PM Aizhamal Nurmamat kyzy <
>> [hidden email]>
>> wrote:
>>
>> > +Konstantin Knauf <[hidden email]> this is looking good,
>> thanks
>> > for sharing!
>> >
>> > I also created a similar doc for Apache Airflow [1]. It is a bit messy,
>> > but it has questions from the application form that you can work with.
>> >
>> > Cheers,
>> > Aizhamal
>> >
>> > [1]
>> >
>> https://docs.google.com/document/d/1HoL_yjNYiTAP9IxSlhx3EUnPFU4l9WOT9EnwBZjCZo0/edit#
>> >
>> >
>> > On Mon, Apr 15, 2019 at 2:24 AM Robert Metzger <[hidden email]>
>> > wrote:
>> >
>> >> Hi all,
>> >> I'm very happy to see this project happening!
>> >>
>> >> Thank you for the proposal Konstantin! One idea for the "related
>> >> material": we could also link to talks or blog posts about concepts /
>> >> monitoring / operations. Potential writers could feel overwhelmed by
>> our
>> >> demand for improvements, without any additional material.
>> >>
>> >>
>> >> On Mon, Apr 15, 2019 at 10:16 AM Konstantin Knauf <
>> >> [hidden email]> wrote:
>> >>
>> >>> Hi everyone,
>> >>>
>> >>> thanks @Aizhamal Nurmamat kyzy <[hidden email]>. As we only have
>> >>> one
>> >>> week left until the application deadline, I went ahead and created a
>> >>> document for the project ideas [1]. I have added the description for
>> the
>> >>> "stream processing concepts" as well as the "deployment & operations
>> >>> documentation" project idea. Please let me know what you think, edit &
>> >>> comment. We also need descriptions for the other two projects (Table
>> >>> API/SQL & Flink Internals). @Fabian/@Jark/@Stephan can you chime in?
>> >>>
>> >>> Any more project ideas?
>> >>>
>> >>> Best,
>> >>>
>> >>> Konstantin
>> >>>
>> >>>
>> >>> [1]
>> >>>
>> >>>
>> https://docs.google.com/document/d/1Up53jNsLztApn-mP76AB6xWUVGt3nwS9p6xQTiceKXo/edit?usp=sharing
>> >>>
>> >>>
>> >>>
>> >>> On Fri, Apr 12, 2019 at 6:50 PM Aizhamal Nurmamat kyzy <
>> >>> [hidden email]>
>> >>> wrote:
>> >>>
>> >>> > Hello everyone,
>> >>> >
>> >>> > @Konstantin Knauf <[hidden email]> - yes, you are
>> correct.
>> >>> > Between steps 1 and 2 though, the open source organization, in this
>> >>> case
>> >>> > Flink, has to be selected by SoD as one of the participating orgs
>> >>> *fingers
>> >>> > crossed*.
>> >>> >
>> >>> > One tip about organizing ideas is that you want to communicate
>> >>> potential
>> >>> > projects to the tech writers that are applying. Just make sure the
>> >>> scope of
>> >>> > the project is clear to them. The SoD wants to set up the tech
>> writers
>> >>> for
>> >>> > success by making sure the work can be done in the allotted time.
>> >>> >
>> >>> > Hope it helps.
>> >>> >
>> >>> > Aizhamal
>> >>> >
>> >>> >
>> >>> >
>> >>> > On Fri, Apr 12, 2019 at 7:37 AM Konstantin Knauf <
>> >>> [hidden email]>
>> >>> > wrote:
>> >>> >
>> >>> >> Hi all,
>> >>> >>
>> >>> >> I read through the SoD documentation again, and now I think, it
>> would
>> >>> >> actually make sense to split (1) up into multiple project ideas.
>> Let
>> >>> me
>> >>> >> summarize the overall process:
>> >>> >>
>> >>> >> 1. We create & publish a list of project ideas, e.g. in a blog
>> post.
>> >>> >> (This can be any number of ideas.)
>> >>> >> 2. Potential technical writers look at our list of ideas and sent a
>> >>> >> proposal for a particular project to Google. During that time they
>> can
>> >>> >> reach out to us for clarification.
>> >>> >> 3. Google forwards all proposals for our project ideas to us and we
>> >>> sent
>> >>> >> back a prioritized list of proposals, which we would like to
>> accept.
>> >>> >> 4. Of all these proposals, Google accepts 50 proposals for SoD
>> 2019.
>> >>> Per
>> >>> >> organization Google will only accept a maximum of two proposals.
>> >>> >>
>> >>> >> @Aizhamal Nurmamat kyzy <[hidden email]> Please correct me!
>> >>> >>
>> >>> >> For me this means we should splits this up in a way, that each
>> >>> project is
>> >>> >> a) still relevant in September b) makes sense as a 3 month project.
>> >>> Based
>> >>> >> on the ideas we have right now these could for example be:
>> >>> >>
>> >>> >> (I) Rework/Extract/Improve the documentation of stream processing
>> >>> concepts
>> >>> >> (II) Improve & extend Apache Flink's documentation for deployment,
>> >>> >> operations (incl. configuration)
>> >>> >> (III) Add documentation for Flink internals
>> >>> >> (IV) Rework Table API / SQL documentation
>> >>> >>
>> >>> >> We would then get proposals potentially for all of these topics and
>> >>> could
>> >>> >> decide which of these proposals, we would sent back to Google. My
>> >>> feeling
>> >>> >> is that a technical writer could easily spent three months on any
>> of
>> >>> these
>> >>> >> projects. What do others think? Any other project ideas?
>> >>> >>
>> >>> >> Cheers,
>> >>> >>
>> >>> >> Konstantin
>> >>> >>
>> >>> >>
>> >>> >>
>> >>> >>
>> >>> >> On Fri, Apr 12, 2019 at 1:47 PM Jark Wu <[hidden email]> wrote:
>> >>> >>
>> >>> >>> Hi all,
>> >>> >>>
>> >>> >>> I'm fine with only preparing the first proposal. I think it's
>> >>> reasonable
>> >>> >>> because the first proposal is more attractive
>> >>> >>> and maybe there is not enough Chinese writer. We can focus on one
>> >>> project
>> >>> >>> to come up with a concrete and
>> >>> >>> attractive project plan.
>> >>> >>>
>> >>> >>> One possible subproject could be rework Table SQL docs.
>> >>> >>> (1). Improve concepts in Table SQL.
>> >>> >>> (2). A more detailed introduction of built-in functions,
>> currently we
>> >>> >>> only
>> >>> >>> have a simple explanation for each function.
>> >>> >>>       We should add more descriptions, especially more concrete
>> >>> examples,
>> >>> >>> and maybe some notes. We can take
>> >>> >>>       MySQL doc [1] as a reference.
>> >>> >>> (3). As Flink SQL is evolving rapidly and features from Blink is
>> >>> being
>> >>> >>> merged,  for example, SQL DDL, Hive integration,
>> >>> >>>       Python Table API, Interactive Programing, SQL optimization
>> and
>> >>> >>> tuning, etc... We can redesign the doc structure of
>> >>> >>>       Table SQL in a higher vision.
>> >>> >>>
>> >>> >>> Cheers,
>> >>> >>> Jark
>> >>> >>>
>> >>> >>> [1]:
>> >>> >>>
>> >>> >>>
>> >>>
>> https://dev.mysql.com/doc/refman/5.7/en/string-functions.html#function_bin
>> >>> >>>
>> >>> >>>
>> >>> >>>
>> >>> >>> On Fri, 12 Apr 2019 at 18:19, jincheng sun <
>> [hidden email]
>> >>> >
>> >>> >>> wrote:
>> >>> >>>
>> >>> >>> > I am honored to have the opportunity to do a second organization
>> >>> >>> > administrator‘s works!
>> >>> >>> >
>> >>> >>> > It seems that one project and multiple projects have their own
>> >>> >>> advantages.
>> >>> >>> >
>> >>> >>> > My understanding is that even if we only have one project, we
>> also
>> >>> can
>> >>> >>> have
>> >>> >>> > multiple mentors and recruit enough writers.
>> >>> >>> >
>> >>> >>> > Fabian Hueske <[hidden email]> 于2019年4月12日周五 下午5:57写道：
>> >>> >>> >
>> >>> >>> > > Yes, I think we would get at most one project accepted.
>> >>> >>> > > Having all options in a rather generic proposal gives us the
>> most
>> >>> >>> > > flexibility to decide what to work on once the proposal is
>> >>> accepted.
>> >>> >>> > > On the other hand, a more concrete proposal might look more
>> >>> >>> attractive
>> >>> >>> > for
>> >>> >>> > > candidates.
>> >>> >>> > > I'm fine either way, but my gut feeling is that a well scoped
>> >>> >>> proposal
>> >>> >>> > > gives better changes of finding a writer (which might be the
>> >>> biggest
>> >>> >>> > > challenge).
>> >>> >>> > >
>> >>> >>> > > Am Fr., 12. Apr. 2019 um 11:39 Uhr schrieb Stephan Ewen <
>> >>> >>> > [hidden email]
>> >>> >>> > > >:
>> >>> >>> > >
>> >>> >>> > > > I would suggest to make one proposal and have the
>> subsections
>> >>> only
>> >>> >>> in
>> >>> >>> > the
>> >>> >>> > > > project plan.
>> >>> >>> > > > My understanding is that we need to indicate priorities
>> between
>> >>> >>> > proposals
>> >>> >>> > > > and might get only one, so it would be good to not
>> subdivide.
>> >>> >>> > > >
>> >>> >>> > > > On Fri, Apr 12, 2019 at 9:58 AM Fabian Hueske <
>> >>> [hidden email]>
>> >>> >>> > wrote:
>> >>> >>> > > >
>> >>> >>> > > > > Hi everyone,
>> >>> >>> > > > >
>> >>> >>> > > > > I think we can split the first project that Stephan
>> proposed
>> >>> into
>> >>> >>> > > smaller
>> >>> >>> > > > > ones:
>> >>> >>> > > > >
>> >>> >>> > > > > > (1) Create or rework setup / tutorials / concepts docs
>> >>> >>> > > > > > (2) Complete (or advance) the Chinese translation
>> >>> >>> > > > >
>> >>> >>> > > > > 1.1 Improving (extracting) the documentation of stream
>> >>> processing
>> >>> >>> > > > concepts:
>> >>> >>> > > > > Event-time, Timers, State, State Backends, Checkpointing,
>> >>> >>> Savepoints
>> >>> >>> > > > > Right now, the relevant information is scattered across
>> >>> several
>> >>> >>> pages
>> >>> >>> > > and
>> >>> >>> > > > > mixed with the implementation / APIs / configuration
>> options.
>> >>> >>> > > > >
>> >>> >>> > > > > 1.2 Improving & extending the documentation of deployments
>> >>> >>> > > > >
>> >>> >>> > > > > 1.3 Adding documentation in the internals: Distributed
>> >>> >>> architecture,
>> >>> >>> > > > > recovery, operators, job translation, execution, etc.
>> >>> >>> > > > > This documentation would be targeted to Flink developers.
>> >>> >>> > > > >
>> >>> >>> > > > > I thought again about the idea of improving the tutorials,
>> >>> and
>> >>> >>> I'm no
>> >>> >>> > > > > longer sure if this would fit SoD well.
>> >>> >>> > > > > The reason is that creating good tutorials requires a good
>> >>> >>> portion of
>> >>> >>> > > > > coding / configuration (creating Docker images, example
>> >>> programs,
>> >>> >>> > > etc.).
>> >>> >>> > > > > Also I'd like to start improving the situation of
>> tutorials
>> >>> >>> earlier
>> >>> >>> > > than
>> >>> >>> > > > > September.
>> >>> >>> > > > >
>> >>> >>> > > > > What do others think?
>> >>> >>> > > > >
>> >>> >>> > > > > Cheers, Fabian
>> >>> >>> > > > >
>> >>> >>> > > > >
>> >>> >>> > > > > Am Fr., 12. Apr. 2019 um 04:29 Uhr schrieb Jark Wu <
>> >>> >>> [hidden email]
>> >>> >>> > >:
>> >>> >>> > > > >
>> >>> >>> > > > > > Hi Konstantin, Ken,
>> >>> >>> > > > > >
>> >>> >>> > > > > > I agree that Chinese documentation is mainly a
>> translation.
>> >>> >>> > > > > >
>> >>> >>> > > > > > >  Does anyone from the Blink team have input on whether
>> >>> there
>> >>> >>> is
>> >>> >>> > > > > existing,
>> >>> >>> > > > > > original Chinese documentation which should be
>> translated
>> >>> to
>> >>> >>> > English?
>> >>> >>> > > > > >
>> >>> >>> > > > > > There is a public Blink documentation [1] which is
>> English.
>> >>> >>> > > > > > We have a Blink Chinese documentation in internal, but I
>> >>> think
>> >>> >>> we
>> >>> >>> > > need
>> >>> >>> > > > to
>> >>> >>> > > > > > rewrite it in English and restructure it when
>> contributing
>> >>> >>> Blink to
>> >>> >>> > > > > Flink.
>> >>> >>> > > > > >
>> >>> >>> > > > > > Regarding the Chinese translation project, I agree with
>> >>> Ken's
>> >>> >>> > > opinion.
>> >>> >>> > > > > >
>> >>> >>> > > > > > From the point of my translation experience, translation
>> >>> is a
>> >>> >>> work
>> >>> >>> > > that
>> >>> >>> > > > > > need to understand the original English sentence
>> correctly
>> >>> and
>> >>> >>> then
>> >>> >>> > > > > express
>> >>> >>> > > > > > it in Chinese in an easily understandable way. This is
>> not
>> >>> a
>> >>> >>> simple
>> >>> >>> > > > work
>> >>> >>> > > > > > that translate word by word. The one we need is not a
>> >>> >>> "professional
>> >>> >>> > > > > > translator",
>> >>> >>> > > > > > but a "technical writer who are familiar with both
>> >>> >>> languages".  I
>> >>> >>> > > also
>> >>> >>> > > > > > agree that the writer who write the initial
>> documentation
>> >>> has
>> >>> >>> the
>> >>> >>> > > > better
>> >>> >>> > > > > > ability than
>> >>> >>> > > > > > translator to distill complex technical concepts.
>> >>> >>> > > > > >
>> >>> >>> > > > > > [1]: https://flink-china.org/doc/blink
>> >>> >>> > > > > >
>> >>> >>> > > > > > On Fri, 12 Apr 2019 at 02:40, Ken Krugler <
>> >>> >>> > > [hidden email]
>> >>> >>> > > > >
>> >>> >>> > > > > > wrote:
>> >>> >>> > > > > >
>> >>> >>> > > > > > > Hi Konstantin,
>> >>> >>> > > > > > >
>> >>> >>> > > > > > > Comments inline below…
>> >>> >>> > > > > > >
>> >>> >>> > > > > > > — Ken
>> >>> >>> > > > > > >
>> >>> >>> > > > > > > > On Apr 11, 2019, at 9:05 AM, Konstantin Knauf <
>> >>> >>> > > > > > [hidden email]>
>> >>> >>> > > > > > > wrote:
>> >>> >>> > > > > > > >
>> >>> >>> > > > > > > > Hi everyone,
>> >>> >>> > > > > > > >
>> >>> >>> > > > > > > > I will start going through the registration process
>> >>> >>> tomorrow
>> >>> >>> > > (CET).
>> >>> >>> > > > > > > > Jincheng (cc) reached out to me directly and offered
>> >>> to be
>> >>> >>> the
>> >>> >>> > > > second
>> >>> >>> > > > > > > > organization administrator. So, we are all set in
>> that
>> >>> >>> regard.
>> >>> >>> > > > > > > >
>> >>> >>> > > > > > > > In terms of mentors, we now have
>> >>> >>> > > > > > > >
>> >>> >>> > > > > > > > * myself
>> >>> >>> > > > > > > > * Fabian
>> >>> >>> > > > > > > > * David
>> >>> >>> > > > > > > > * Stephan
>> >>> >>> > > > > > > > * Jark (Chinese Translation)
>> >>> >>> > > > > > > >
>> >>> >>> > > > > > > > Regarding the Chinese translation project, it is
>> >>> probably a
>> >>> >>> > > > question
>> >>> >>> > > > > of
>> >>> >>> > > > > > > how
>> >>> >>> > > > > > > > independent the Chinese version is supposed to be.
>> If
>> >>> the
>> >>> >>> > English
>> >>> >>> > > > > > > > documentation is the ground-truth and the Chinese
>> >>> >>> documentation
>> >>> >>> > > is
>> >>> >>> > > > > > > (mainly)
>> >>> >>> > > > > > > > a translation, I agree with Stefan. If the Chinese
>> >>> >>> > documentation
>> >>> >>> > > is
>> >>> >>> > > > > > > > supposed to become an independent secondary
>> >>> documentation,
>> >>> >>> it
>> >>> >>> > > could
>> >>> >>> > > > > be
>> >>> >>> > > > > > a
>> >>> >>> > > > > > > > project for a technical writer as well. Has this
>> >>> questions
>> >>> >>> > > already
>> >>> >>> > > > > been
>> >>> >>> > > > > > > > discussed in the community?
>> >>> >>> > > > > > >
>> >>> >>> > > > > > > My understanding is that the Chinese documentation is
>> >>> going
>> >>> >>> to
>> >>> >>> > > mostly
>> >>> >>> > > > > be
>> >>> >>> > > > > > a
>> >>> >>> > > > > > > translation of the English versions.
>> >>> >>> > > > > > >
>> >>> >>> > > > > > > Though perhaps, with all of the Blink integration
>> going
>> >>> on,
>> >>> >>> the
>> >>> >>> > > > inverse
>> >>> >>> > > > > > > could also be true.
>> >>> >>> > > > > > >
>> >>> >>> > > > > > > Does anyone from the Blink team have input on whether
>> >>> there
>> >>> >>> is
>> >>> >>> > > > > existing,
>> >>> >>> > > > > > > original Chinese documentation which should be
>> >>> translated to
>> >>> >>> > > English?
>> >>> >>> > > > > > >
>> >>> >>> > > > > > > > On Thu, Apr 11, 2019 at 11:34 AM Stephan Ewen <
>> >>> >>> > [hidden email]>
>> >>> >>> > > > > > wrote:
>> >>> >>> > > > > > > >
>> >>> >>> > > > > > > >> So we have two ideas for docs projects now:
>> >>> >>> > > > > > > >>
>> >>> >>> > > > > > > >> (1) Create or rework setup / tutorials / concepts
>> docs
>> >>> >>> > > > > > > >> (2) Complete (or advance) the Chinese translation
>> >>> >>> > > > > > > >>
>> >>> >>> > > > > > > >> Should we apply for both (and let the SoD committee
>> >>> select
>> >>> >>> > > > whichever
>> >>> >>> > > > > > > they
>> >>> >>> > > > > > > >> want to sponsor) or select one of them?
>> >>> >>> > > > > > > >>
>> >>> >>> > > > > > > >> For project (2), this sounds to me more like a
>> project
>> >>> >>> for a
>> >>> >>> > > > > > > "translator",
>> >>> >>> > > > > > > >> not a "technical writer". As far as I understand
>> it,
>> >>> the
>> >>> >>> big
>> >>> >>> > > > benefit
>> >>> >>> > > > > > of
>> >>> >>> > > > > > > >> having a technical writer is to have someone who
>> can
>> >>> >>> describe
>> >>> >>> > > > > > > complicated
>> >>> >>> > > > > > > >> technical concepts (that engineers describe in
>> >>> complicated
>> >>> >>> > > > language)
>> >>> >>> > > > > > in
>> >>> >>> > > > > > > an
>> >>> >>> > > > > > > >> easily understandable way.
>> >>> >>> > > > > > >
>> >>> >>> > > > > > > Actually a good Chinese translation of the technical
>> docs
>> >>> >>> > requires
>> >>> >>> > > > > > someone
>> >>> >>> > > > > > > with many of the same skills. In order for the
>> >>> translation
>> >>> >>> to be
>> >>> >>> > > > > > accurate,
>> >>> >>> > > > > > > you need someone who understands the concepts of the
>> >>> >>> underlying
>> >>> >>> > > > > > technology,
>> >>> >>> > > > > > > to use appropriate terminology. Though I agree that
>> the
>> >>> >>> ability
>> >>> >>> > to
>> >>> >>> > > > > > distill
>> >>> >>> > > > > > > complex technical concepts is more important when
>> writing
>> >>> >>> initial
>> >>> >>> > > > > > > documentation.
>> >>> >>> > > > > > >
>> >>> >>> > > > > > >
>> >>> >>> > > > > > > >> On Thu, Apr 11, 2019 at 9:47 AM Fabian Hueske <
>> >>> >>> > > [hidden email]>
>> >>> >>> > > > > > > wrote:
>> >>> >>> > > > > > > >>
>> >>> >>> > > > > > > >>> Thanks for the clarification Aizhamal!
>> >>> >>> > > > > > > >>> This is really helpful and will make it a lot
>> easier
>> >>> to
>> >>> >>> > > > coordinate
>> >>> >>> > > > > > :-)
>> >>> >>> > > > > > > >>>
>> >>> >>> > > > > > > >>> As for next steps, I found this email on the
>> >>> >>> > > > > > [hidden email]
>> >>> >>> > > > > > > >>> mailing list:
>> >>> >>> > > > > > > >>>
>> >>> >>> > > > > > > >>> ==================================================
>> >>> >>> > > > > > > >>> Hi All,
>> >>> >>> > > > > > > >>>
>> >>> >>> > > > > > > >>> As mentioned the applications for the Google
>> Season
>> >>> of
>> >>> >>> Docs
>> >>> >>> > > > opened
>> >>> >>> > > > > > > today
>> >>> >>> > > > > > > >>> and I'm working my way through it on behalf of the
>> >>> ASF.
>> >>> >>> > > > > > > >>>
>> >>> >>> > > > > > > >>> If accepted, we will be allocated either one or
>> two
>> >>> >>> techical
>> >>> >>> > > > > writers.
>> >>> >>> > > > > > > >>> Google will also pay the ASF a stipend of $500 per
>> >>> >>> technical
>> >>> >>> > > > writer
>> >>> >>> > > > > > > >>> mentored (which I hope can go directly to
>> >>> fundraising :-)
>> >>> >>> > > > > > > >>>
>> >>> >>> > > > > > > >>> Each project that wants to participate must
>> provide
>> >>> two
>> >>> >>> > mentors
>> >>> >>> > > > for
>> >>> >>> > > > > > > each
>> >>> >>> > > > > > > >>> documentation project.
>> >>> >>> > > > > > > >>>
>> >>> >>> > > > > > > >>> As part of the application process there are a few
>> >>> things
>> >>> >>> > that
>> >>> >>> > > we
>> >>> >>> > > > > > need
>> >>> >>> > > > > > > to
>> >>> >>> > > > > > > >>> setup.
>> >>> >>> > > > > > > >>>
>> >>> >>> > > > > > > >>> 1. Season of Docs Page and List of Project Ideas
>> >>> >>> > > > > > > >>> We need to create a public webpage about Season of
>> >>> Docs
>> >>> >>> that
>> >>> >>> > > > > contains
>> >>> >>> > > > > > > the
>> >>> >>> > > > > > > >>> list of project ideas for documentation. I have
>> >>> created a
>> >>> >>> > page
>> >>> >>> > > on
>> >>> >>> > > > > the
>> >>> >>> > > > > > > >>> ComDev wiki https://s.apache.org/w4CH  with a
>> table
>> >>> for
>> >>> >>> > > projects
>> >>> >>> > > > > to
>> >>> >>> > > > > > > >> record
>> >>> >>> > > > > > > >>> their ideas.
>> >>> >>> > > > > > > >>>
>> >>> >>> > > > > > > >>> 2. Alternative administrator.
>> >>> >>> > > > > > > >>> I’ve set myself up as the primary admin and Maxim
>> as
>> >>> the
>> >>> >>> > > > > alternative
>> >>> >>> > > > > > > >> admin
>> >>> >>> > > > > > > >>> (Maxim, I need to confirm your contact email and
>> you
>> >>> will
>> >>> >>> > also
>> >>> >>> > > > need
>> >>> >>> > > > > > to
>> >>> >>> > > > > > > >>> register as the alternative admin and I will email
>> >>> you
>> >>> >>> the
>> >>> >>> > link
>> >>> >>> > > > > > > offline)
>> >>> >>> > > > > > > >>>
>> >>> >>> > > > > > > >>> 3. Mentors
>> >>> >>> > > > > > > >>> All mentors from the projects interested in
>> >>> participating
>> >>> >>> > must
>> >>> >>> > > > > > register
>> >>> >>> > > > > > > >>> individually at the following link :
>> >>> >>> > > > > > > https://forms.gle/a1x26WQGzURLerv66
>> >>> >>> > > > > > > >> .
>> >>> >>> > > > > > > >>>
>> >>> >>> > > > > > > >>> 4. Application Form: Documentation / Technnial
>> Writer
>> >>> >>> > > > Collaboration
>> >>> >>> > > > > > > >>> There is a section to fill in about experience
>> with
>> >>> >>> > > documentation
>> >>> >>> > > > > and
>> >>> >>> > > > > > > any
>> >>> >>> > > > > > > >>> previous collaboration with technical writers. I
>> >>> know a
>> >>> >>> few
>> >>> >>> > > > > projects
>> >>> >>> > > > > > > have
>> >>> >>> > > > > > > >>> used various tools for documentation - but not
>> sure
>> >>> >>> about any
>> >>> >>> > > > > > technical
>> >>> >>> > > > > > > >>> writing collaboration (so if you know of any then
>> >>> please
>> >>> >>> let
>> >>> >>> > me
>> >>> >>> > > > > know)
>> >>> >>> > > > > > > >>>
>> >>> >>> > > > > > > >>> 5. Application Form: GSoC
>> >>> >>> > > > > > > >>> There is a section to complete at our
>> participation
>> >>> in
>> >>> >>> GSoC.I
>> >>> >>> > > > > think I
>> >>> >>> > > > > > > >> have
>> >>> >>> > > > > > > >>> the details from our application this year so can
>> >>> follow
>> >>> >>> up
>> >>> >>> > > with
>> >>> >>> > > > > > Maxim
>> >>> >>> > > > > > > or
>> >>> >>> > > > > > > >>> Uli about it
>> >>> >>> > > > > > > >>>
>> >>> >>> > > > > > > >>> This is all I have at the moment and we have until
>> >>> the
>> >>> >>> 23rd
>> >>> >>> > > April
>> >>> >>> > > > > > 2019
>> >>> >>> > > > > > > to
>> >>> >>> > > > > > > >>> finalise all the application details. Ideally I
>> want
>> >>> to
>> >>> >>> have
>> >>> >>> > it
>> >>> >>> > > > > done
>> >>> >>> > > > > > > well
>> >>> >>> > > > > > > >>> before then :-)
>> >>> >>> > > > > > > >>>
>> >>> >>> > > > > > > >>> Please pass on this information within your
>> various
>> >>> >>> projects
>> >>> >>> > > and
>> >>> >>> > > > as
>> >>> >>> > > > > > > with
>> >>> >>> > > > > > > >>> GSoC - I'll see how we can get this information
>> out
>> >>> to
>> >>> >>> all
>> >>> >>> > our
>> >>> >>> > > > > > project
>> >>> >>> > > > > > > >>> mailing lists.
>> >>> >>> > > > > > > >>>
>> >>> >>> > > > > > > >>> Thanks
>> >>> >>> > > > > > > >>> Sharan
>> >>> >>> > > > > > > >>>
>> >>> >>> > > > > > > >>> ==================================================
>> >>> >>> > > > > > > >>>
>> >>> >>> > > > > > > >>> I guess, we would need to follow these steps as
>> well.
>> >>> >>> > > > > > > >>>
>> >>> >>> > > > > > > >>> Best,
>> >>> >>> > > > > > > >>> Fabian
>> >>> >>> > > > > > > >>>
>> >>> >>> > > > > > > >>> Am Do., 11. Apr. 2019 um 05:08 Uhr schrieb Jark
>> Wu <
>> >>> >>> > > > > [hidden email]
>> >>> >>> > > > > > >:
>> >>> >>> > > > > > > >>>
>> >>> >>> > > > > > > >>>> Hi Aizhamal,
>> >>> >>> > > > > > > >>>>
>> >>> >>> > > > > > > >>>> That's really interesting. We have an ongoing
>> >>> proposal
>> >>> >>> for
>> >>> >>> > > > > > supporting
>> >>> >>> > > > > > > >>>> Chinese documentation, see FLIP-35 [1].
>> >>> >>> > > > > > > >>>>
>> >>> >>> > > > > > > >>>> I think it's a good idea to propose Chinese
>> >>> translation
>> >>> >>> as a
>> >>> >>> > > > > > project.
>> >>> >>> > > > > > > >>> It's
>> >>> >>> > > > > > > >>>> a good chance to improve the localization user
>> >>> >>> experience of
>> >>> >>> > > > Flink
>> >>> >>> > > > > > > >>>> documentation.
>> >>> >>> > > > > > > >>>> I can help as a mentor if we want to submit such
>> a
>> >>> >>> project.
>> >>> >>> > > > > > > >>>>
>> >>> >>> > > > > > > >>>> Thanks,
>> >>> >>> > > > > > > >>>> Jark Wu
>> >>> >>> > > > > > > >>>>
>> >>> >>> > > > > > > >>>> [1]:
>> >>> >>> > > > > > > >>>>
>> >>> >>> > > > > > > >>>
>> >>> >>> > > > > > > >>
>> >>> >>> > > > > > >
>> >>> >>> > > > > >
>> >>> >>> > > > >
>> >>> >>> > > >
>> >>> >>> > >
>> >>> >>> >
>> >>> >>>
>> >>>
>> https://cwiki.apache.org/confluence/display/FLINK/FLIP-35%3A+Support+Chinese+Documents+and+Website
>> >>> >>> > > > > > > >>>>
>> >>> >>> > > > > > > >>>> On Thu, 11 Apr 2019 at 02:11, Aizhamal Nurmamat
>> kyzy
>> >>> >>> > > > > > > >>>> <[hidden email]> wrote:
>> >>> >>> > > > > > > >>>>
>> >>> >>> > > > > > > >>>>> Hello everyone,
>> >>> >>> > > > > > > >>>>>
>> >>> >>> > > > > > > >>>>> @Fabian Hueske <[hidden email]> - SoD setup
>> is
>> >>> a
>> >>> >>> little
>> >>> >>> > > bit
>> >>> >>> > > > > > > >>> different.
>> >>> >>> > > > > > > >>>>> The ASF determined that each project would be
>> >>> allowed
>> >>> >>> to
>> >>> >>> > > apply
>> >>> >>> > > > > > > >>>>> individually[1], rather than applying as a
>> single
>> >>> large
>> >>> >>> > > > > > organization.
>> >>> >>> > > > > > > >>>>>
>> >>> >>> > > > > > > >>>>> Each project applies as an org, with two
>> organizers
>> >>> >>> > > > (administers)
>> >>> >>> > > > > > and
>> >>> >>> > > > > > > >> at
>> >>> >>> > > > > > > >>>>> least two mentors. As Konstantin pointed out,
>> one
>> >>> can
>> >>> >>> be
>> >>> >>> > both
>> >>> >>> > > > an
>> >>> >>> > > > > > > >>>>> administer
>> >>> >>> > > > > > > >>>>> and a mentor. You don't need to coordinate with
>> >>> other
>> >>> >>> > > projects
>> >>> >>> > > > or
>> >>> >>> > > > > > ASF
>> >>> >>> > > > > > > >> at
>> >>> >>> > > > > > > >>>>> all. If accepted to the program, you will
>> receive
>> >>> >>> project
>> >>> >>> > > > > proposals
>> >>> >>> > > > > > > >> from
>> >>> >>> > > > > > > >>>>> tech writers [2]. You will choose one or two
>> >>> proposals
>> >>> >>> that
>> >>> >>> > > you
>> >>> >>> > > > > > want
>> >>> >>> > > > > > > >> to
>> >>> >>> > > > > > > >>>>> mentor[3].
>> >>> >>> > > > > > > >>>>>
>> >>> >>> > > > > > > >>>>> @Ken - as for the language, there isn’t any
>> >>> >>> limitations in
>> >>> >>> > > that
>> >>> >>> > > > > > > >> regard,
>> >>> >>> > > > > > > >>> so
>> >>> >>> > > > > > > >>>>> work on the Chinese translation for the website
>> is
>> >>> >>> > definitely
>> >>> >>> > > > an
>> >>> >>> > > > > > > >>>>> acceptable
>> >>> >>> > > > > > > >>>>> project.
>> >>> >>> > > > > > > >>>>>
>> >>> >>> > > > > > > >>>>> Thanks,
>> >>> >>> > > > > > > >>>>>
>> >>> >>> > > > > > > >>>>> Aizhamal
>> >>> >>> > > > > > > >>>>>
>> >>> >>> > > > > > > >>>>>
>> >>> >>> > > > > > > >>>>> [1]
>> >>> >>> > > > > > > >>>>>
>> >>> >>> > > > > > > >>>>>
>> >>> >>> > > > > > > >>>
>> >>> >>> > > > > > > >>
>> >>> >>> > > > > > >
>> >>> >>> > > > > >
>> >>> >>> > > > >
>> >>> >>> > > >
>> >>> >>> > >
>> >>> >>> >
>> >>> >>>
>> >>>
>> https://lists.apache.org/thread.html/67e1c2e6041cff1e7f198b615407401f032795130e796adfaacf8071@%3Cdev.community.apache.org%3E
>> >>> >>> > > > > > > >>>>>
>> >>> >>> > > > > > > >>>>> [2]
>> >>> https://developers.google.com/season-of-docs/docs/
>> >>> >>> > > > > > > >>>>>
>> >>> >>> > > > > > > >>>>> [3]
>> >>> >>> > > > > > > >>>
>> >>> >>> > > > > >
>> >>> >>> > >
>> >>> >>>
>> >>> https://developers.google.com/season-of-docs/docs/faq#slot-allocation
>> >>> >>> > > > > > > >>>>>
>> >>> >>> > > > > > > >>>>>
>> >>> >>> > > > > > > >>>>> On Wed, Apr 10, 2019 at 8:32 AM Ken Krugler <
>> >>> >>> > > > > > > >>> [hidden email]>
>> >>> >>> > > > > > > >>>>> wrote:
>> >>> >>> > > > > > > >>>>>
>> >>> >>> > > > > > > >>>>>> Hi Aizhamal,
>> >>> >>> > > > > > > >>>>>>
>> >>> >>> > > > > > > >>>>>> I assume SoD is language-agnostic, so one
>> possible
>> >>> >>> project
>> >>> >>> > > > would
>> >>> >>> > > > > > be
>> >>> >>> > > > > > > >> to
>> >>> >>> > > > > > > >>>>> get
>> >>> >>> > > > > > > >>>>>> a tech writer for the Chinese versions of all
>> of
>> >>> the
>> >>> >>> Flink
>> >>> >>> > > > > > > >>>>> documentation,
>> >>> >>> > > > > > > >>>>>> yes?
>> >>> >>> > > > > > > >>>>>>
>> >>> >>> > > > > > > >>>>>> Regards,
>> >>> >>> > > > > > > >>>>>>
>> >>> >>> > > > > > > >>>>>> — Ken
>> >>> >>> > > > > > > >>>>>>
>> >>> >>> > > > > > > >>>>>>> On Apr 5, 2019, at 3:43 PM, Aizhamal Nurmamat
>> >>> kyzy
>> >>> >>> > > > > > > >>>>>> <[hidden email]> wrote:
>> >>> >>> > > > > > > >>>>>>>
>> >>> >>> > > > > > > >>>>>>> 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
>> >>> >>> > > > > > >
>> >>> >>> > > > > > > --------------------------
>> >>> >>> > > > > > > Ken Krugler
>> >>> >>> > > > > > > [phone]
>> >>> >>> > > > > > > http://www.scaleunlimited.com
>> >>> >>> > > > > > > Custom big data solutions & training
>> >>> >>> > > > > > > Flink, Solr, Hadoop, Cascading & Cassandra
>> >>> >>> > > > > > >
>> >>> >>> > > > > > >
>> >>> >>> > > > > >
>> >>> >>> > > > >
>> >>> >>> > > >
>> >>> >>> > >
>> >>> >>> >
>> >>> >>>
>> >>> >>
>> >>> >>
>> >>> >> --
>> >>> >>
>> >>> >> Konstantin Knauf | Solutions Architect
>> >>> >>
>> >>> >> [phone]
>> >>> >>
>> >>> >> <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
>> >>> >>
>> >>> >
>> >>>
>> >>> --
>> >>>
>> >>> Konstantin Knauf | Solutions Architect
>> >>>
>> >>> [phone]
>> >>>
>> >>> <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
>> >>>
>> >>
>>
>> --
>>
>> Konstantin Knauf | Solutions Architect
>>
>> [phone]
>>
>>
>> Planned Absences: 17.04.2019 - 26.04.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
>>
>

[jincheng sun]

Thanks Konstantin!

I registered as an alternative administrator,  and have had left few
comments at the blog post.

Best,
Jincheng

Fabian Hueske <[hidden email]> 于2019年4月18日周四 上午12:36写道：

> Thanks Konstantin!
>
> I registered as a mentor and will have a look at the blog post.
>
> Best, Fabian
>
> Am Mi., 17. Apr. 2019 um 18:14 Uhr schrieb Konstantin Knauf <
> [hidden email]>:
>
> > Hi everyone,
> >
> > a few updates on our application:
> >
> > 1. As Aizhamal (Thanks!) has suggested I also added the information to
> > submit during our application to the Google doc [1] and Fabian added a
> > description for the SQL project idea (Thanks!).
> >
> > 2. I had a quick chat with Fabian offline and we concluded, that the
> "Flink
> > Internals" project might not be good fit for Season of Docs after all,
> > because, we think, the amount of mentoring by core developers that would
> be
> > necessary to produce such a documentation could not be guaranteed. Any
> > opinions?
> >
> > 3. To submit our application, we need to publish our project ideas list.
> > For this I have just opened a PR to add a small blog post about Season of
> > Docs [2]. Please have a look and provide feedback.
> >
> > 4. For mentors (Stephan, Fabian, Jark, David) please complete the mentor
> > registration [3] by next Tuesday (*Application Deadline*)
> >
> > Cheers,
> >
> > Konstantin
> >
> > [1]
> >
> >
> https://docs.google.com/document/d/1Up53jNsLztApn-mP76AB6xWUVGt3nwS9p6xQTiceKXo/edit?usp=sharing
> > [2] https://github.com/apache/flink-web/pull/202
> > [3]
> >
> >
> https://docs.google.com/forms/d/e/1FAIpQLSe-JjGvaKKGWZOXxrorONhB8qN3mjPrB9ZVkcsntR73Cv_K7g/viewform
> >
> > On Mon, Apr 15, 2019 at 9:12 PM Aizhamal Nurmamat kyzy <
> > [hidden email]>
> > wrote:
> >
> > > +Konstantin Knauf <[hidden email]> this is looking good,
> > thanks
> > > for sharing!
> > >
> > > I also created a similar doc for Apache Airflow [1]. It is a bit messy,
> > > but it has questions from the application form that you can work with.
> > >
> > > Cheers,
> > > Aizhamal
> > >
> > > [1]
> > >
> >
> https://docs.google.com/document/d/1HoL_yjNYiTAP9IxSlhx3EUnPFU4l9WOT9EnwBZjCZo0/edit#
> > >
> > >
> > > On Mon, Apr 15, 2019 at 2:24 AM Robert Metzger <[hidden email]>
> > > wrote:
> > >
> > >> Hi all,
> > >> I'm very happy to see this project happening!
> > >>
> > >> Thank you for the proposal Konstantin! One idea for the "related
> > >> material": we could also link to talks or blog posts about concepts /
> > >> monitoring / operations. Potential writers could feel overwhelmed by
> our
> > >> demand for improvements, without any additional material.
> > >>
> > >>
> > >> On Mon, Apr 15, 2019 at 10:16 AM Konstantin Knauf <
> > >> [hidden email]> wrote:
> > >>
> > >>> Hi everyone,
> > >>>
> > >>> thanks @Aizhamal Nurmamat kyzy <[hidden email]>. As we only
> have
> > >>> one
> > >>> week left until the application deadline, I went ahead and created a
> > >>> document for the project ideas [1]. I have added the description for
> > the
> > >>> "stream processing concepts" as well as the "deployment & operations
> > >>> documentation" project idea. Please let me know what you think, edit
> &
> > >>> comment. We also need descriptions for the other two projects (Table
> > >>> API/SQL & Flink Internals). @Fabian/@Jark/@Stephan can you chime in?
> > >>>
> > >>> Any more project ideas?
> > >>>
> > >>> Best,
> > >>>
> > >>> Konstantin
> > >>>
> > >>>
> > >>> [1]
> > >>>
> > >>>
> >
> https://docs.google.com/document/d/1Up53jNsLztApn-mP76AB6xWUVGt3nwS9p6xQTiceKXo/edit?usp=sharing
> > >>>
> > >>>
> > >>>
> > >>> On Fri, Apr 12, 2019 at 6:50 PM Aizhamal Nurmamat kyzy <
> > >>> [hidden email]>
> > >>> wrote:
> > >>>
> > >>> > Hello everyone,
> > >>> >
> > >>> > @Konstantin Knauf <[hidden email]> - yes, you are
> correct.
> > >>> > Between steps 1 and 2 though, the open source organization, in this
> > >>> case
> > >>> > Flink, has to be selected by SoD as one of the participating orgs
> > >>> *fingers
> > >>> > crossed*.
> > >>> >
> > >>> > One tip about organizing ideas is that you want to communicate
> > >>> potential
> > >>> > projects to the tech writers that are applying. Just make sure the
> > >>> scope of
> > >>> > the project is clear to them. The SoD wants to set up the tech
> > writers
> > >>> for
> > >>> > success by making sure the work can be done in the allotted time.
> > >>> >
> > >>> > Hope it helps.
> > >>> >
> > >>> > Aizhamal
> > >>> >
> > >>> >
> > >>> >
> > >>> > On Fri, Apr 12, 2019 at 7:37 AM Konstantin Knauf <
> > >>> [hidden email]>
> > >>> > wrote:
> > >>> >
> > >>> >> Hi all,
> > >>> >>
> > >>> >> I read through the SoD documentation again, and now I think, it
> > would
> > >>> >> actually make sense to split (1) up into multiple project ideas.
> Let
> > >>> me
> > >>> >> summarize the overall process:
> > >>> >>
> > >>> >> 1. We create & publish a list of project ideas, e.g. in a blog
> post.
> > >>> >> (This can be any number of ideas.)
> > >>> >> 2. Potential technical writers look at our list of ideas and sent
> a
> > >>> >> proposal for a particular project to Google. During that time they
> > can
> > >>> >> reach out to us for clarification.
> > >>> >> 3. Google forwards all proposals for our project ideas to us and
> we
> > >>> sent
> > >>> >> back a prioritized list of proposals, which we would like to
> accept.
> > >>> >> 4. Of all these proposals, Google accepts 50 proposals for SoD
> 2019.
> > >>> Per
> > >>> >> organization Google will only accept a maximum of two proposals.
> > >>> >>
> > >>> >> @Aizhamal Nurmamat kyzy <[hidden email]> Please correct me!
> > >>> >>
> > >>> >> For me this means we should splits this up in a way, that each
> > >>> project is
> > >>> >> a) still relevant in September b) makes sense as a 3 month
> project.
> > >>> Based
> > >>> >> on the ideas we have right now these could for example be:
> > >>> >>
> > >>> >> (I) Rework/Extract/Improve the documentation of stream processing
> > >>> concepts
> > >>> >> (II) Improve & extend Apache Flink's documentation for deployment,
> > >>> >> operations (incl. configuration)
> > >>> >> (III) Add documentation for Flink internals
> > >>> >> (IV) Rework Table API / SQL documentation
> > >>> >>
> > >>> >> We would then get proposals potentially for all of these topics
> and
> > >>> could
> > >>> >> decide which of these proposals, we would sent back to Google. My
> > >>> feeling
> > >>> >> is that a technical writer could easily spent three months on any
> of
> > >>> these
> > >>> >> projects. What do others think? Any other project ideas?
> > >>> >>
> > >>> >> Cheers,
> > >>> >>
> > >>> >> Konstantin
> > >>> >>
> > >>> >>
> > >>> >>
> > >>> >>
> > >>> >> On Fri, Apr 12, 2019 at 1:47 PM Jark Wu <[hidden email]> wrote:
> > >>> >>
> > >>> >>> Hi all,
> > >>> >>>
> > >>> >>> I'm fine with only preparing the first proposal. I think it's
> > >>> reasonable
> > >>> >>> because the first proposal is more attractive
> > >>> >>> and maybe there is not enough Chinese writer. We can focus on one
> > >>> project
> > >>> >>> to come up with a concrete and
> > >>> >>> attractive project plan.
> > >>> >>>
> > >>> >>> One possible subproject could be rework Table SQL docs.
> > >>> >>> (1). Improve concepts in Table SQL.
> > >>> >>> (2). A more detailed introduction of built-in functions,
> currently
> > we
> > >>> >>> only
> > >>> >>> have a simple explanation for each function.
> > >>> >>>       We should add more descriptions, especially more concrete
> > >>> examples,
> > >>> >>> and maybe some notes. We can take
> > >>> >>>       MySQL doc [1] as a reference.
> > >>> >>> (3). As Flink SQL is evolving rapidly and features from Blink is
> > >>> being
> > >>> >>> merged,  for example, SQL DDL, Hive integration,
> > >>> >>>       Python Table API, Interactive Programing, SQL optimization
> > and
> > >>> >>> tuning, etc... We can redesign the doc structure of
> > >>> >>>       Table SQL in a higher vision.
> > >>> >>>
> > >>> >>> Cheers,
> > >>> >>> Jark
> > >>> >>>
> > >>> >>> [1]:
> > >>> >>>
> > >>> >>>
> > >>>
> >
> https://dev.mysql.com/doc/refman/5.7/en/string-functions.html#function_bin
> > >>> >>>
> > >>> >>>
> > >>> >>>
> > >>> >>> On Fri, 12 Apr 2019 at 18:19, jincheng sun <
> > [hidden email]
> > >>> >
> > >>> >>> wrote:
> > >>> >>>
> > >>> >>> > I am honored to have the opportunity to do a second
> organization
> > >>> >>> > administrator‘s works!
> > >>> >>> >
> > >>> >>> > It seems that one project and multiple projects have their own
> > >>> >>> advantages.
> > >>> >>> >
> > >>> >>> > My understanding is that even if we only have one project, we
> > also
> > >>> can
> > >>> >>> have
> > >>> >>> > multiple mentors and recruit enough writers.
> > >>> >>> >
> > >>> >>> > Fabian Hueske <[hidden email]> 于2019年4月12日周五 下午5:57写道：
> > >>> >>> >
> > >>> >>> > > Yes, I think we would get at most one project accepted.
> > >>> >>> > > Having all options in a rather generic proposal gives us the
> > most
> > >>> >>> > > flexibility to decide what to work on once the proposal is
> > >>> accepted.
> > >>> >>> > > On the other hand, a more concrete proposal might look more
> > >>> >>> attractive
> > >>> >>> > for
> > >>> >>> > > candidates.
> > >>> >>> > > I'm fine either way, but my gut feeling is that a well scoped
> > >>> >>> proposal
> > >>> >>> > > gives better changes of finding a writer (which might be the
> > >>> biggest
> > >>> >>> > > challenge).
> > >>> >>> > >
> > >>> >>> > > Am Fr., 12. Apr. 2019 um 11:39 Uhr schrieb Stephan Ewen <
> > >>> >>> > [hidden email]
> > >>> >>> > > >:
> > >>> >>> > >
> > >>> >>> > > > I would suggest to make one proposal and have the
> subsections
> > >>> only
> > >>> >>> in
> > >>> >>> > the
> > >>> >>> > > > project plan.
> > >>> >>> > > > My understanding is that we need to indicate priorities
> > between
> > >>> >>> > proposals
> > >>> >>> > > > and might get only one, so it would be good to not
> subdivide.
> > >>> >>> > > >
> > >>> >>> > > > On Fri, Apr 12, 2019 at 9:58 AM Fabian Hueske <
> > >>> [hidden email]>
> > >>> >>> > wrote:
> > >>> >>> > > >
> > >>> >>> > > > > Hi everyone,
> > >>> >>> > > > >
> > >>> >>> > > > > I think we can split the first project that Stephan
> > proposed
> > >>> into
> > >>> >>> > > smaller
> > >>> >>> > > > > ones:
> > >>> >>> > > > >
> > >>> >>> > > > > > (1) Create or rework setup / tutorials / concepts docs
> > >>> >>> > > > > > (2) Complete (or advance) the Chinese translation
> > >>> >>> > > > >
> > >>> >>> > > > > 1.1 Improving (extracting) the documentation of stream
> > >>> processing
> > >>> >>> > > > concepts:
> > >>> >>> > > > > Event-time, Timers, State, State Backends, Checkpointing,
> > >>> >>> Savepoints
> > >>> >>> > > > > Right now, the relevant information is scattered across
> > >>> several
> > >>> >>> pages
> > >>> >>> > > and
> > >>> >>> > > > > mixed with the implementation / APIs / configuration
> > options.
> > >>> >>> > > > >
> > >>> >>> > > > > 1.2 Improving & extending the documentation of
> deployments
> > >>> >>> > > > >
> > >>> >>> > > > > 1.3 Adding documentation in the internals: Distributed
> > >>> >>> architecture,
> > >>> >>> > > > > recovery, operators, job translation, execution, etc.
> > >>> >>> > > > > This documentation would be targeted to Flink developers.
> > >>> >>> > > > >
> > >>> >>> > > > > I thought again about the idea of improving the
> tutorials,
> > >>> and
> > >>> >>> I'm no
> > >>> >>> > > > > longer sure if this would fit SoD well.
> > >>> >>> > > > > The reason is that creating good tutorials requires a
> good
> > >>> >>> portion of
> > >>> >>> > > > > coding / configuration (creating Docker images, example
> > >>> programs,
> > >>> >>> > > etc.).
> > >>> >>> > > > > Also I'd like to start improving the situation of
> tutorials
> > >>> >>> earlier
> > >>> >>> > > than
> > >>> >>> > > > > September.
> > >>> >>> > > > >
> > >>> >>> > > > > What do others think?
> > >>> >>> > > > >
> > >>> >>> > > > > Cheers, Fabian
> > >>> >>> > > > >
> > >>> >>> > > > >
> > >>> >>> > > > > Am Fr., 12. Apr. 2019 um 04:29 Uhr schrieb Jark Wu <
> > >>> >>> [hidden email]
> > >>> >>> > >:
> > >>> >>> > > > >
> > >>> >>> > > > > > Hi Konstantin, Ken,
> > >>> >>> > > > > >
> > >>> >>> > > > > > I agree that Chinese documentation is mainly a
> > translation.
> > >>> >>> > > > > >
> > >>> >>> > > > > > >  Does anyone from the Blink team have input on
> whether
> > >>> there
> > >>> >>> is
> > >>> >>> > > > > existing,
> > >>> >>> > > > > > original Chinese documentation which should be
> translated
> > >>> to
> > >>> >>> > English?
> > >>> >>> > > > > >
> > >>> >>> > > > > > There is a public Blink documentation [1] which is
> > English.
> > >>> >>> > > > > > We have a Blink Chinese documentation in internal, but
> I
> > >>> think
> > >>> >>> we
> > >>> >>> > > need
> > >>> >>> > > > to
> > >>> >>> > > > > > rewrite it in English and restructure it when
> > contributing
> > >>> >>> Blink to
> > >>> >>> > > > > Flink.
> > >>> >>> > > > > >
> > >>> >>> > > > > > Regarding the Chinese translation project, I agree with
> > >>> Ken's
> > >>> >>> > > opinion.
> > >>> >>> > > > > >
> > >>> >>> > > > > > From the point of my translation experience,
> translation
> > >>> is a
> > >>> >>> work
> > >>> >>> > > that
> > >>> >>> > > > > > need to understand the original English sentence
> > correctly
> > >>> and
> > >>> >>> then
> > >>> >>> > > > > express
> > >>> >>> > > > > > it in Chinese in an easily understandable way. This is
> > not
> > >>> a
> > >>> >>> simple
> > >>> >>> > > > work
> > >>> >>> > > > > > that translate word by word. The one we need is not a
> > >>> >>> "professional
> > >>> >>> > > > > > translator",
> > >>> >>> > > > > > but a "technical writer who are familiar with both
> > >>> >>> languages".  I
> > >>> >>> > > also
> > >>> >>> > > > > > agree that the writer who write the initial
> documentation
> > >>> has
> > >>> >>> the
> > >>> >>> > > > better
> > >>> >>> > > > > > ability than
> > >>> >>> > > > > > translator to distill complex technical concepts.
> > >>> >>> > > > > >
> > >>> >>> > > > > > [1]: https://flink-china.org/doc/blink
> > >>> >>> > > > > >
> > >>> >>> > > > > > On Fri, 12 Apr 2019 at 02:40, Ken Krugler <
> > >>> >>> > > [hidden email]
> > >>> >>> > > > >
> > >>> >>> > > > > > wrote:
> > >>> >>> > > > > >
> > >>> >>> > > > > > > Hi Konstantin,
> > >>> >>> > > > > > >
> > >>> >>> > > > > > > Comments inline below…
> > >>> >>> > > > > > >
> > >>> >>> > > > > > > — Ken
> > >>> >>> > > > > > >
> > >>> >>> > > > > > > > On Apr 11, 2019, at 9:05 AM, Konstantin Knauf <
> > >>> >>> > > > > > [hidden email]>
> > >>> >>> > > > > > > wrote:
> > >>> >>> > > > > > > >
> > >>> >>> > > > > > > > Hi everyone,
> > >>> >>> > > > > > > >
> > >>> >>> > > > > > > > I will start going through the registration process
> > >>> >>> tomorrow
> > >>> >>> > > (CET).
> > >>> >>> > > > > > > > Jincheng (cc) reached out to me directly and
> offered
> > >>> to be
> > >>> >>> the
> > >>> >>> > > > second
> > >>> >>> > > > > > > > organization administrator. So, we are all set in
> > that
> > >>> >>> regard.
> > >>> >>> > > > > > > >
> > >>> >>> > > > > > > > In terms of mentors, we now have
> > >>> >>> > > > > > > >
> > >>> >>> > > > > > > > * myself
> > >>> >>> > > > > > > > * Fabian
> > >>> >>> > > > > > > > * David
> > >>> >>> > > > > > > > * Stephan
> > >>> >>> > > > > > > > * Jark (Chinese Translation)
> > >>> >>> > > > > > > >
> > >>> >>> > > > > > > > Regarding the Chinese translation project, it is
> > >>> probably a
> > >>> >>> > > > question
> > >>> >>> > > > > of
> > >>> >>> > > > > > > how
> > >>> >>> > > > > > > > independent the Chinese version is supposed to be.
> If
> > >>> the
> > >>> >>> > English
> > >>> >>> > > > > > > > documentation is the ground-truth and the Chinese
> > >>> >>> documentation
> > >>> >>> > > is
> > >>> >>> > > > > > > (mainly)
> > >>> >>> > > > > > > > a translation, I agree with Stefan. If the Chinese
> > >>> >>> > documentation
> > >>> >>> > > is
> > >>> >>> > > > > > > > supposed to become an independent secondary
> > >>> documentation,
> > >>> >>> it
> > >>> >>> > > could
> > >>> >>> > > > > be
> > >>> >>> > > > > > a
> > >>> >>> > > > > > > > project for a technical writer as well. Has this
> > >>> questions
> > >>> >>> > > already
> > >>> >>> > > > > been
> > >>> >>> > > > > > > > discussed in the community?
> > >>> >>> > > > > > >
> > >>> >>> > > > > > > My understanding is that the Chinese documentation is
> > >>> going
> > >>> >>> to
> > >>> >>> > > mostly
> > >>> >>> > > > > be
> > >>> >>> > > > > > a
> > >>> >>> > > > > > > translation of the English versions.
> > >>> >>> > > > > > >
> > >>> >>> > > > > > > Though perhaps, with all of the Blink integration
> going
> > >>> on,
> > >>> >>> the
> > >>> >>> > > > inverse
> > >>> >>> > > > > > > could also be true.
> > >>> >>> > > > > > >
> > >>> >>> > > > > > > Does anyone from the Blink team have input on whether
> > >>> there
> > >>> >>> is
> > >>> >>> > > > > existing,
> > >>> >>> > > > > > > original Chinese documentation which should be
> > >>> translated to
> > >>> >>> > > English?
> > >>> >>> > > > > > >
> > >>> >>> > > > > > > > On Thu, Apr 11, 2019 at 11:34 AM Stephan Ewen <
> > >>> >>> > [hidden email]>
> > >>> >>> > > > > > wrote:
> > >>> >>> > > > > > > >
> > >>> >>> > > > > > > >> So we have two ideas for docs projects now:
> > >>> >>> > > > > > > >>
> > >>> >>> > > > > > > >> (1) Create or rework setup / tutorials / concepts
> > docs
> > >>> >>> > > > > > > >> (2) Complete (or advance) the Chinese translation
> > >>> >>> > > > > > > >>
> > >>> >>> > > > > > > >> Should we apply for both (and let the SoD
> committee
> > >>> select
> > >>> >>> > > > whichever
> > >>> >>> > > > > > > they
> > >>> >>> > > > > > > >> want to sponsor) or select one of them?
> > >>> >>> > > > > > > >>
> > >>> >>> > > > > > > >> For project (2), this sounds to me more like a
> > project
> > >>> >>> for a
> > >>> >>> > > > > > > "translator",
> > >>> >>> > > > > > > >> not a "technical writer". As far as I understand
> it,
> > >>> the
> > >>> >>> big
> > >>> >>> > > > benefit
> > >>> >>> > > > > > of
> > >>> >>> > > > > > > >> having a technical writer is to have someone who
> can
> > >>> >>> describe
> > >>> >>> > > > > > > complicated
> > >>> >>> > > > > > > >> technical concepts (that engineers describe in
> > >>> complicated
> > >>> >>> > > > language)
> > >>> >>> > > > > > in
> > >>> >>> > > > > > > an
> > >>> >>> > > > > > > >> easily understandable way.
> > >>> >>> > > > > > >
> > >>> >>> > > > > > > Actually a good Chinese translation of the technical
> > docs
> > >>> >>> > requires
> > >>> >>> > > > > > someone
> > >>> >>> > > > > > > with many of the same skills. In order for the
> > >>> translation
> > >>> >>> to be
> > >>> >>> > > > > > accurate,
> > >>> >>> > > > > > > you need someone who understands the concepts of the
> > >>> >>> underlying
> > >>> >>> > > > > > technology,
> > >>> >>> > > > > > > to use appropriate terminology. Though I agree that
> the
> > >>> >>> ability
> > >>> >>> > to
> > >>> >>> > > > > > distill
> > >>> >>> > > > > > > complex technical concepts is more important when
> > writing
> > >>> >>> initial
> > >>> >>> > > > > > > documentation.
> > >>> >>> > > > > > >
> > >>> >>> > > > > > >
> > >>> >>> > > > > > > >> On Thu, Apr 11, 2019 at 9:47 AM Fabian Hueske <
> > >>> >>> > > [hidden email]>
> > >>> >>> > > > > > > wrote:
> > >>> >>> > > > > > > >>
> > >>> >>> > > > > > > >>> Thanks for the clarification Aizhamal!
> > >>> >>> > > > > > > >>> This is really helpful and will make it a lot
> > easier
> > >>> to
> > >>> >>> > > > coordinate
> > >>> >>> > > > > > :-)
> > >>> >>> > > > > > > >>>
> > >>> >>> > > > > > > >>> As for next steps, I found this email on the
> > >>> >>> > > > > > [hidden email]
> > >>> >>> > > > > > > >>> mailing list:
> > >>> >>> > > > > > > >>>
> > >>> >>> > > > > > > >>>
> ==================================================
> > >>> >>> > > > > > > >>> Hi All,
> > >>> >>> > > > > > > >>>
> > >>> >>> > > > > > > >>> As mentioned the applications for the Google
> Season
> > >>> of
> > >>> >>> Docs
> > >>> >>> > > > opened
> > >>> >>> > > > > > > today
> > >>> >>> > > > > > > >>> and I'm working my way through it on behalf of
> the
> > >>> ASF.
> > >>> >>> > > > > > > >>>
> > >>> >>> > > > > > > >>> If accepted, we will be allocated either one or
> two
> > >>> >>> techical
> > >>> >>> > > > > writers.
> > >>> >>> > > > > > > >>> Google will also pay the ASF a stipend of $500
> per
> > >>> >>> technical
> > >>> >>> > > > writer
> > >>> >>> > > > > > > >>> mentored (which I hope can go directly to
> > >>> fundraising :-)
> > >>> >>> > > > > > > >>>
> > >>> >>> > > > > > > >>> Each project that wants to participate must
> provide
> > >>> two
> > >>> >>> > mentors
> > >>> >>> > > > for
> > >>> >>> > > > > > > each
> > >>> >>> > > > > > > >>> documentation project.
> > >>> >>> > > > > > > >>>
> > >>> >>> > > > > > > >>> As part of the application process there are a
> few
> > >>> things
> > >>> >>> > that
> > >>> >>> > > we
> > >>> >>> > > > > > need
> > >>> >>> > > > > > > to
> > >>> >>> > > > > > > >>> setup.
> > >>> >>> > > > > > > >>>
> > >>> >>> > > > > > > >>> 1. Season of Docs Page and List of Project Ideas
> > >>> >>> > > > > > > >>> We need to create a public webpage about Season
> of
> > >>> Docs
> > >>> >>> that
> > >>> >>> > > > > contains
> > >>> >>> > > > > > > the
> > >>> >>> > > > > > > >>> list of project ideas for documentation. I have
> > >>> created a
> > >>> >>> > page
> > >>> >>> > > on
> > >>> >>> > > > > the
> > >>> >>> > > > > > > >>> ComDev wiki https://s.apache.org/w4CH  with a
> > table
> > >>> for
> > >>> >>> > > projects
> > >>> >>> > > > > to
> > >>> >>> > > > > > > >> record
> > >>> >>> > > > > > > >>> their ideas.
> > >>> >>> > > > > > > >>>
> > >>> >>> > > > > > > >>> 2. Alternative administrator.
> > >>> >>> > > > > > > >>> I’ve set myself up as the primary admin and Maxim
> > as
> > >>> the
> > >>> >>> > > > > alternative
> > >>> >>> > > > > > > >> admin
> > >>> >>> > > > > > > >>> (Maxim, I need to confirm your contact email and
> > you
> > >>> will
> > >>> >>> > also
> > >>> >>> > > > need
> > >>> >>> > > > > > to
> > >>> >>> > > > > > > >>> register as the alternative admin and I will
> email
> > >>> you
> > >>> >>> the
> > >>> >>> > link
> > >>> >>> > > > > > > offline)
> > >>> >>> > > > > > > >>>
> > >>> >>> > > > > > > >>> 3. Mentors
> > >>> >>> > > > > > > >>> All mentors from the projects interested in
> > >>> participating
> > >>> >>> > must
> > >>> >>> > > > > > register
> > >>> >>> > > > > > > >>> individually at the following link :
> > >>> >>> > > > > > > https://forms.gle/a1x26WQGzURLerv66
> > >>> >>> > > > > > > >> .
> > >>> >>> > > > > > > >>>
> > >>> >>> > > > > > > >>> 4. Application Form: Documentation / Technnial
> > Writer
> > >>> >>> > > > Collaboration
> > >>> >>> > > > > > > >>> There is a section to fill in about experience
> with
> > >>> >>> > > documentation
> > >>> >>> > > > > and
> > >>> >>> > > > > > > any
> > >>> >>> > > > > > > >>> previous collaboration with technical writers. I
> > >>> know a
> > >>> >>> few
> > >>> >>> > > > > projects
> > >>> >>> > > > > > > have
> > >>> >>> > > > > > > >>> used various tools for documentation - but not
> sure
> > >>> >>> about any
> > >>> >>> > > > > > technical
> > >>> >>> > > > > > > >>> writing collaboration (so if you know of any then
> > >>> please
> > >>> >>> let
> > >>> >>> > me
> > >>> >>> > > > > know)
> > >>> >>> > > > > > > >>>
> > >>> >>> > > > > > > >>> 5. Application Form: GSoC
> > >>> >>> > > > > > > >>> There is a section to complete at our
> participation
> > >>> in
> > >>> >>> GSoC.I
> > >>> >>> > > > > think I
> > >>> >>> > > > > > > >> have
> > >>> >>> > > > > > > >>> the details from our application this year so can
> > >>> follow
> > >>> >>> up
> > >>> >>> > > with
> > >>> >>> > > > > > Maxim
> > >>> >>> > > > > > > or
> > >>> >>> > > > > > > >>> Uli about it
> > >>> >>> > > > > > > >>>
> > >>> >>> > > > > > > >>> This is all I have at the moment and we have
> until
> > >>> the
> > >>> >>> 23rd
> > >>> >>> > > April
> > >>> >>> > > > > > 2019
> > >>> >>> > > > > > > to
> > >>> >>> > > > > > > >>> finalise all the application details. Ideally I
> > want
> > >>> to
> > >>> >>> have
> > >>> >>> > it
> > >>> >>> > > > > done
> > >>> >>> > > > > > > well
> > >>> >>> > > > > > > >>> before then :-)
> > >>> >>> > > > > > > >>>
> > >>> >>> > > > > > > >>> Please pass on this information within your
> various
> > >>> >>> projects
> > >>> >>> > > and
> > >>> >>> > > > as
> > >>> >>> > > > > > > with
> > >>> >>> > > > > > > >>> GSoC - I'll see how we can get this information
> out
> > >>> to
> > >>> >>> all
> > >>> >>> > our
> > >>> >>> > > > > > project
> > >>> >>> > > > > > > >>> mailing lists.
> > >>> >>> > > > > > > >>>
> > >>> >>> > > > > > > >>> Thanks
> > >>> >>> > > > > > > >>> Sharan
> > >>> >>> > > > > > > >>>
> > >>> >>> > > > > > > >>>
> ==================================================
> > >>> >>> > > > > > > >>>
> > >>> >>> > > > > > > >>> I guess, we would need to follow these steps as
> > well.
> > >>> >>> > > > > > > >>>
> > >>> >>> > > > > > > >>> Best,
> > >>> >>> > > > > > > >>> Fabian
> > >>> >>> > > > > > > >>>
> > >>> >>> > > > > > > >>> Am Do., 11. Apr. 2019 um 05:08 Uhr schrieb Jark
> Wu
> > <
> > >>> >>> > > > > [hidden email]
> > >>> >>> > > > > > >:
> > >>> >>> > > > > > > >>>
> > >>> >>> > > > > > > >>>> Hi Aizhamal,
> > >>> >>> > > > > > > >>>>
> > >>> >>> > > > > > > >>>> That's really interesting. We have an ongoing
> > >>> proposal
> > >>> >>> for
> > >>> >>> > > > > > supporting
> > >>> >>> > > > > > > >>>> Chinese documentation, see FLIP-35 [1].
> > >>> >>> > > > > > > >>>>
> > >>> >>> > > > > > > >>>> I think it's a good idea to propose Chinese
> > >>> translation
> > >>> >>> as a
> > >>> >>> > > > > > project.
> > >>> >>> > > > > > > >>> It's
> > >>> >>> > > > > > > >>>> a good chance to improve the localization user
> > >>> >>> experience of
> > >>> >>> > > > Flink
> > >>> >>> > > > > > > >>>> documentation.
> > >>> >>> > > > > > > >>>> I can help as a mentor if we want to submit
> such a
> > >>> >>> project.
> > >>> >>> > > > > > > >>>>
> > >>> >>> > > > > > > >>>> Thanks,
> > >>> >>> > > > > > > >>>> Jark Wu
> > >>> >>> > > > > > > >>>>
> > >>> >>> > > > > > > >>>> [1]:
> > >>> >>> > > > > > > >>>>
> > >>> >>> > > > > > > >>>
> > >>> >>> > > > > > > >>
> > >>> >>> > > > > > >
> > >>> >>> > > > > >
> > >>> >>> > > > >
> > >>> >>> > > >
> > >>> >>> > >
> > >>> >>> >
> > >>> >>>
> > >>>
> >
> https://cwiki.apache.org/confluence/display/FLINK/FLIP-35%3A+Support+Chinese+Documents+and+Website
> > >>> >>> > > > > > > >>>>
> > >>> >>> > > > > > > >>>> On Thu, 11 Apr 2019 at 02:11, Aizhamal Nurmamat
> > kyzy
> > >>> >>> > > > > > > >>>> <[hidden email]> wrote:
> > >>> >>> > > > > > > >>>>
> > >>> >>> > > > > > > >>>>> Hello everyone,
> > >>> >>> > > > > > > >>>>>
> > >>> >>> > > > > > > >>>>> @Fabian Hueske <[hidden email]> - SoD setup
> > is
> > >>> a
> > >>> >>> little
> > >>> >>> > > bit
> > >>> >>> > > > > > > >>> different.
> > >>> >>> > > > > > > >>>>> The ASF determined that each project would be
> > >>> allowed
> > >>> >>> to
> > >>> >>> > > apply
> > >>> >>> > > > > > > >>>>> individually[1], rather than applying as a
> single
> > >>> large
> > >>> >>> > > > > > organization.
> > >>> >>> > > > > > > >>>>>
> > >>> >>> > > > > > > >>>>> Each project applies as an org, with two
> > organizers
> > >>> >>> > > > (administers)
> > >>> >>> > > > > > and
> > >>> >>> > > > > > > >> at
> > >>> >>> > > > > > > >>>>> least two mentors. As Konstantin pointed out,
> one
> > >>> can
> > >>> >>> be
> > >>> >>> > both
> > >>> >>> > > > an
> > >>> >>> > > > > > > >>>>> administer
> > >>> >>> > > > > > > >>>>> and a mentor. You don't need to coordinate with
> > >>> other
> > >>> >>> > > projects
> > >>> >>> > > > or
> > >>> >>> > > > > > ASF
> > >>> >>> > > > > > > >> at
> > >>> >>> > > > > > > >>>>> all. If accepted to the program, you will
> receive
> > >>> >>> project
> > >>> >>> > > > > proposals
> > >>> >>> > > > > > > >> from
> > >>> >>> > > > > > > >>>>> tech writers [2]. You will choose one or two
> > >>> proposals
> > >>> >>> that
> > >>> >>> > > you
> > >>> >>> > > > > > want
> > >>> >>> > > > > > > >> to
> > >>> >>> > > > > > > >>>>> mentor[3].
> > >>> >>> > > > > > > >>>>>
> > >>> >>> > > > > > > >>>>> @Ken - as for the language, there isn’t any
> > >>> >>> limitations in
> > >>> >>> > > that
> > >>> >>> > > > > > > >> regard,
> > >>> >>> > > > > > > >>> so
> > >>> >>> > > > > > > >>>>> work on the Chinese translation for the website
> > is
> > >>> >>> > definitely
> > >>> >>> > > > an
> > >>> >>> > > > > > > >>>>> acceptable
> > >>> >>> > > > > > > >>>>> project.
> > >>> >>> > > > > > > >>>>>
> > >>> >>> > > > > > > >>>>> Thanks,
> > >>> >>> > > > > > > >>>>>
> > >>> >>> > > > > > > >>>>> Aizhamal
> > >>> >>> > > > > > > >>>>>
> > >>> >>> > > > > > > >>>>>
> > >>> >>> > > > > > > >>>>> [1]
> > >>> >>> > > > > > > >>>>>
> > >>> >>> > > > > > > >>>>>
> > >>> >>> > > > > > > >>>
> > >>> >>> > > > > > > >>
> > >>> >>> > > > > > >
> > >>> >>> > > > > >
> > >>> >>> > > > >
> > >>> >>> > > >
> > >>> >>> > >
> > >>> >>> >
> > >>> >>>
> > >>>
> >
> https://lists.apache.org/thread.html/67e1c2e6041cff1e7f198b615407401f032795130e796adfaacf8071@%3Cdev.community.apache.org%3E
> > >>> >>> > > > > > > >>>>>
> > >>> >>> > > > > > > >>>>> [2]
> > >>> https://developers.google.com/season-of-docs/docs/
> > >>> >>> > > > > > > >>>>>
> > >>> >>> > > > > > > >>>>> [3]
> > >>> >>> > > > > > > >>>
> > >>> >>> > > > > >
> > >>> >>> > >
> > >>> >>>
> > >>>
> https://developers.google.com/season-of-docs/docs/faq#slot-allocation
> > >>> >>> > > > > > > >>>>>
> > >>> >>> > > > > > > >>>>>
> > >>> >>> > > > > > > >>>>> On Wed, Apr 10, 2019 at 8:32 AM Ken Krugler <
> > >>> >>> > > > > > > >>> [hidden email]>
> > >>> >>> > > > > > > >>>>> wrote:
> > >>> >>> > > > > > > >>>>>
> > >>> >>> > > > > > > >>>>>> Hi Aizhamal,
> > >>> >>> > > > > > > >>>>>>
> > >>> >>> > > > > > > >>>>>> I assume SoD is language-agnostic, so one
> > possible
> > >>> >>> project
> > >>> >>> > > > would
> > >>> >>> > > > > > be
> > >>> >>> > > > > > > >> to
> > >>> >>> > > > > > > >>>>> get
> > >>> >>> > > > > > > >>>>>> a tech writer for the Chinese versions of all
> of
> > >>> the
> > >>> >>> Flink
> > >>> >>> > > > > > > >>>>> documentation,
> > >>> >>> > > > > > > >>>>>> yes?
> > >>> >>> > > > > > > >>>>>>
> > >>> >>> > > > > > > >>>>>> Regards,
> > >>> >>> > > > > > > >>>>>>
> > >>> >>> > > > > > > >>>>>> — Ken
> > >>> >>> > > > > > > >>>>>>
> > >>> >>> > > > > > > >>>>>>> On Apr 5, 2019, at 3:43 PM, Aizhamal Nurmamat
> > >>> kyzy
> > >>> >>> > > > > > > >>>>>> <[hidden email]> wrote:
> > >>> >>> > > > > > > >>>>>>>
> > >>> >>> > > > > > > >>>>>>> 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
> > >>> >>> > > > > > >
> > >>> >>> > > > > > > --------------------------
> > >>> >>> > > > > > > Ken Krugler
> > >>> >>> > > > > > > [phone]
> > >>> >>> > > > > > > http://www.scaleunlimited.com
> > >>> >>> > > > > > > Custom big data solutions & training
> > >>> >>> > > > > > > Flink, Solr, Hadoop, Cascading & Cassandra
> > >>> >>> > > > > > >
> > >>> >>> > > > > > >
> > >>> >>> > > > > >
> > >>> >>> > > > >
> > >>> >>> > > >
> > >>> >>> > >
> > >>> >>> >
> > >>> >>>
> > >>> >>
> > >>> >>
> > >>> >> --
> > >>> >>
> > >>> >> Konstantin Knauf | Solutions Architect
> > >>> >>
> > >>> >> [phone]
> > >>> >>
> > >>> >> <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
> > >>> >>
> > >>> >
> > >>>
> > >>> --
> > >>>
> > >>> Konstantin Knauf | Solutions Architect
> > >>>
> > >>> [phone]
> > >>>
> > >>> <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
> > >>>
> > >>
> >
> > --
> >
> > Konstantin Knauf | Solutions Architect
> >
> > [phone]
> >
> >
> > Planned Absences: 17.04.2019 - 26.04.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
> >
>

[jincheng sun]

Hi Konstantin&all,

The  blog post is released, please see
https://flink.apache.org/news/2019/04/17/sod.html

And I think is better to spread the word by https://twitter.com/ApacheFlink,
but I found that only PMC can manage and publish messages.

Help spread the word here:
https://twitter.com/sunjincheng121/status/1118831783762481152

Best,
Jincheng

jincheng sun <[hidden email]> 于2019年4月18日周四 上午11:01写道：

> Thanks Konstantin!
>
> I registered as an alternative administrator,  and have had left few
> comments at the blog post.
>
> Best,
> Jincheng
>
> Fabian Hueske <[hidden email]> 于2019年4月18日周四 上午12:36写道：
>
>> Thanks Konstantin!
>>
>> I registered as a mentor and will have a look at the blog post.
>>
>> Best, Fabian
>>
>> Am Mi., 17. Apr. 2019 um 18:14 Uhr schrieb Konstantin Knauf <
>> [hidden email]>:
>>
>> > Hi everyone,
>> >
>> > a few updates on our application:
>> >
>> > 1. As Aizhamal (Thanks!) has suggested I also added the information to
>> > submit during our application to the Google doc [1] and Fabian added a
>> > description for the SQL project idea (Thanks!).
>> >
>> > 2. I had a quick chat with Fabian offline and we concluded, that the
>> "Flink
>> > Internals" project might not be good fit for Season of Docs after all,
>> > because, we think, the amount of mentoring by core developers that
>> would be
>> > necessary to produce such a documentation could not be guaranteed. Any
>> > opinions?
>> >
>> > 3. To submit our application, we need to publish our project ideas list.
>> > For this I have just opened a PR to add a small blog post about Season
>> of
>> > Docs [2]. Please have a look and provide feedback.
>> >
>> > 4. For mentors (Stephan, Fabian, Jark, David) please complete the mentor
>> > registration [3] by next Tuesday (*Application Deadline*)
>> >
>> > Cheers,
>> >
>> > Konstantin
>> >
>> > [1]
>> >
>> >
>> https://docs.google.com/document/d/1Up53jNsLztApn-mP76AB6xWUVGt3nwS9p6xQTiceKXo/edit?usp=sharing
>> > [2] https://github.com/apache/flink-web/pull/202
>> > [3]
>> >
>> >
>> https://docs.google.com/forms/d/e/1FAIpQLSe-JjGvaKKGWZOXxrorONhB8qN3mjPrB9ZVkcsntR73Cv_K7g/viewform
>> >
>> > On Mon, Apr 15, 2019 at 9:12 PM Aizhamal Nurmamat kyzy <
>> > [hidden email]>
>> > wrote:
>> >
>> > > +Konstantin Knauf <[hidden email]> this is looking good,
>> > thanks
>> > > for sharing!
>> > >
>> > > I also created a similar doc for Apache Airflow [1]. It is a bit
>> messy,
>> > > but it has questions from the application form that you can work with.
>> > >
>> > > Cheers,
>> > > Aizhamal
>> > >
>> > > [1]
>> > >
>> >
>> https://docs.google.com/document/d/1HoL_yjNYiTAP9IxSlhx3EUnPFU4l9WOT9EnwBZjCZo0/edit#
>> > >
>> > >
>> > > On Mon, Apr 15, 2019 at 2:24 AM Robert Metzger <[hidden email]>
>> > > wrote:
>> > >
>> > >> Hi all,
>> > >> I'm very happy to see this project happening!
>> > >>
>> > >> Thank you for the proposal Konstantin! One idea for the "related
>> > >> material": we could also link to talks or blog posts about concepts /
>> > >> monitoring / operations. Potential writers could feel overwhelmed by
>> our
>> > >> demand for improvements, without any additional material.
>> > >>
>> > >>
>> > >> On Mon, Apr 15, 2019 at 10:16 AM Konstantin Knauf <
>> > >> [hidden email]> wrote:
>> > >>
>> > >>> Hi everyone,
>> > >>>
>> > >>> thanks @Aizhamal Nurmamat kyzy <[hidden email]>. As we only
>> have
>> > >>> one
>> > >>> week left until the application deadline, I went ahead and created a
>> > >>> document for the project ideas [1]. I have added the description for
>> > the
>> > >>> "stream processing concepts" as well as the "deployment & operations
>> > >>> documentation" project idea. Please let me know what you think,
>> edit &
>> > >>> comment. We also need descriptions for the other two projects (Table
>> > >>> API/SQL & Flink Internals). @Fabian/@Jark/@Stephan can you chime in?
>> > >>>
>> > >>> Any more project ideas?
>> > >>>
>> > >>> Best,
>> > >>>
>> > >>> Konstantin
>> > >>>
>> > >>>
>> > >>> [1]
>> > >>>
>> > >>>
>> >
>> https://docs.google.com/document/d/1Up53jNsLztApn-mP76AB6xWUVGt3nwS9p6xQTiceKXo/edit?usp=sharing
>> > >>>
>> > >>>
>> > >>>
>> > >>> On Fri, Apr 12, 2019 at 6:50 PM Aizhamal Nurmamat kyzy <
>> > >>> [hidden email]>
>> > >>> wrote:
>> > >>>
>> > >>> > Hello everyone,
>> > >>> >
>> > >>> > @Konstantin Knauf <[hidden email]> - yes, you are
>> correct.
>> > >>> > Between steps 1 and 2 though, the open source organization, in
>> this
>> > >>> case
>> > >>> > Flink, has to be selected by SoD as one of the participating orgs
>> > >>> *fingers
>> > >>> > crossed*.
>> > >>> >
>> > >>> > One tip about organizing ideas is that you want to communicate
>> > >>> potential
>> > >>> > projects to the tech writers that are applying. Just make sure the
>> > >>> scope of
>> > >>> > the project is clear to them. The SoD wants to set up the tech
>> > writers
>> > >>> for
>> > >>> > success by making sure the work can be done in the allotted time.
>> > >>> >
>> > >>> > Hope it helps.
>> > >>> >
>> > >>> > Aizhamal
>> > >>> >
>> > >>> >
>> > >>> >
>> > >>> > On Fri, Apr 12, 2019 at 7:37 AM Konstantin Knauf <
>> > >>> [hidden email]>
>> > >>> > wrote:
>> > >>> >
>> > >>> >> Hi all,
>> > >>> >>
>> > >>> >> I read through the SoD documentation again, and now I think, it
>> > would
>> > >>> >> actually make sense to split (1) up into multiple project ideas.
>> Let
>> > >>> me
>> > >>> >> summarize the overall process:
>> > >>> >>
>> > >>> >> 1. We create & publish a list of project ideas, e.g. in a blog
>> post.
>> > >>> >> (This can be any number of ideas.)
>> > >>> >> 2. Potential technical writers look at our list of ideas and
>> sent a
>> > >>> >> proposal for a particular project to Google. During that time
>> they
>> > can
>> > >>> >> reach out to us for clarification.
>> > >>> >> 3. Google forwards all proposals for our project ideas to us and
>> we
>> > >>> sent
>> > >>> >> back a prioritized list of proposals, which we would like to
>> accept.
>> > >>> >> 4. Of all these proposals, Google accepts 50 proposals for SoD
>> 2019.
>> > >>> Per
>> > >>> >> organization Google will only accept a maximum of two proposals.
>> > >>> >>
>> > >>> >> @Aizhamal Nurmamat kyzy <[hidden email]> Please correct me!
>> > >>> >>
>> > >>> >> For me this means we should splits this up in a way, that each
>> > >>> project is
>> > >>> >> a) still relevant in September b) makes sense as a 3 month
>> project.
>> > >>> Based
>> > >>> >> on the ideas we have right now these could for example be:
>> > >>> >>
>> > >>> >> (I) Rework/Extract/Improve the documentation of stream processing
>> > >>> concepts
>> > >>> >> (II) Improve & extend Apache Flink's documentation for
>> deployment,
>> > >>> >> operations (incl. configuration)
>> > >>> >> (III) Add documentation for Flink internals
>> > >>> >> (IV) Rework Table API / SQL documentation
>> > >>> >>
>> > >>> >> We would then get proposals potentially for all of these topics
>> and
>> > >>> could
>> > >>> >> decide which of these proposals, we would sent back to Google. My
>> > >>> feeling
>> > >>> >> is that a technical writer could easily spent three months on
>> any of
>> > >>> these
>> > >>> >> projects. What do others think? Any other project ideas?
>> > >>> >>
>> > >>> >> Cheers,
>> > >>> >>
>> > >>> >> Konstantin
>> > >>> >>
>> > >>> >>
>> > >>> >>
>> > >>> >>
>> > >>> >> On Fri, Apr 12, 2019 at 1:47 PM Jark Wu <[hidden email]>
>> wrote:
>> > >>> >>
>> > >>> >>> Hi all,
>> > >>> >>>
>> > >>> >>> I'm fine with only preparing the first proposal. I think it's
>> > >>> reasonable
>> > >>> >>> because the first proposal is more attractive
>> > >>> >>> and maybe there is not enough Chinese writer. We can focus on
>> one
>> > >>> project
>> > >>> >>> to come up with a concrete and
>> > >>> >>> attractive project plan.
>> > >>> >>>
>> > >>> >>> One possible subproject could be rework Table SQL docs.
>> > >>> >>> (1). Improve concepts in Table SQL.
>> > >>> >>> (2). A more detailed introduction of built-in functions,
>> currently
>> > we
>> > >>> >>> only
>> > >>> >>> have a simple explanation for each function.
>> > >>> >>>       We should add more descriptions, especially more concrete
>> > >>> examples,
>> > >>> >>> and maybe some notes. We can take
>> > >>> >>>       MySQL doc [1] as a reference.
>> > >>> >>> (3). As Flink SQL is evolving rapidly and features from Blink is
>> > >>> being
>> > >>> >>> merged,  for example, SQL DDL, Hive integration,
>> > >>> >>>       Python Table API, Interactive Programing, SQL optimization
>> > and
>> > >>> >>> tuning, etc... We can redesign the doc structure of
>> > >>> >>>       Table SQL in a higher vision.
>> > >>> >>>
>> > >>> >>> Cheers,
>> > >>> >>> Jark
>> > >>> >>>
>> > >>> >>> [1]:
>> > >>> >>>
>> > >>> >>>
>> > >>>
>> >
>> https://dev.mysql.com/doc/refman/5.7/en/string-functions.html#function_bin
>> > >>> >>>
>> > >>> >>>
>> > >>> >>>
>> > >>> >>> On Fri, 12 Apr 2019 at 18:19, jincheng sun <
>> > [hidden email]
>> > >>> >
>> > >>> >>> wrote:
>> > >>> >>>
>> > >>> >>> > I am honored to have the opportunity to do a second
>> organization
>> > >>> >>> > administrator‘s works!
>> > >>> >>> >
>> > >>> >>> > It seems that one project and multiple projects have their own
>> > >>> >>> advantages.
>> > >>> >>> >
>> > >>> >>> > My understanding is that even if we only have one project, we
>> > also
>> > >>> can
>> > >>> >>> have
>> > >>> >>> > multiple mentors and recruit enough writers.
>> > >>> >>> >
>> > >>> >>> > Fabian Hueske <[hidden email]> 于2019年4月12日周五 下午5:57写道：
>> > >>> >>> >
>> > >>> >>> > > Yes, I think we would get at most one project accepted.
>> > >>> >>> > > Having all options in a rather generic proposal gives us the
>> > most
>> > >>> >>> > > flexibility to decide what to work on once the proposal is
>> > >>> accepted.
>> > >>> >>> > > On the other hand, a more concrete proposal might look more
>> > >>> >>> attractive
>> > >>> >>> > for
>> > >>> >>> > > candidates.
>> > >>> >>> > > I'm fine either way, but my gut feeling is that a well
>> scoped
>> > >>> >>> proposal
>> > >>> >>> > > gives better changes of finding a writer (which might be the
>> > >>> biggest
>> > >>> >>> > > challenge).
>> > >>> >>> > >
>> > >>> >>> > > Am Fr., 12. Apr. 2019 um 11:39 Uhr schrieb Stephan Ewen <
>> > >>> >>> > [hidden email]
>> > >>> >>> > > >:
>> > >>> >>> > >
>> > >>> >>> > > > I would suggest to make one proposal and have the
>> subsections
>> > >>> only
>> > >>> >>> in
>> > >>> >>> > the
>> > >>> >>> > > > project plan.
>> > >>> >>> > > > My understanding is that we need to indicate priorities
>> > between
>> > >>> >>> > proposals
>> > >>> >>> > > > and might get only one, so it would be good to not
>> subdivide.
>> > >>> >>> > > >
>> > >>> >>> > > > On Fri, Apr 12, 2019 at 9:58 AM Fabian Hueske <
>> > >>> [hidden email]>
>> > >>> >>> > wrote:
>> > >>> >>> > > >
>> > >>> >>> > > > > Hi everyone,
>> > >>> >>> > > > >
>> > >>> >>> > > > > I think we can split the first project that Stephan
>> > proposed
>> > >>> into
>> > >>> >>> > > smaller
>> > >>> >>> > > > > ones:
>> > >>> >>> > > > >
>> > >>> >>> > > > > > (1) Create or rework setup / tutorials / concepts docs
>> > >>> >>> > > > > > (2) Complete (or advance) the Chinese translation
>> > >>> >>> > > > >
>> > >>> >>> > > > > 1.1 Improving (extracting) the documentation of stream
>> > >>> processing
>> > >>> >>> > > > concepts:
>> > >>> >>> > > > > Event-time, Timers, State, State Backends,
>> Checkpointing,
>> > >>> >>> Savepoints
>> > >>> >>> > > > > Right now, the relevant information is scattered across
>> > >>> several
>> > >>> >>> pages
>> > >>> >>> > > and
>> > >>> >>> > > > > mixed with the implementation / APIs / configuration
>> > options.
>> > >>> >>> > > > >
>> > >>> >>> > > > > 1.2 Improving & extending the documentation of
>> deployments
>> > >>> >>> > > > >
>> > >>> >>> > > > > 1.3 Adding documentation in the internals: Distributed
>> > >>> >>> architecture,
>> > >>> >>> > > > > recovery, operators, job translation, execution, etc.
>> > >>> >>> > > > > This documentation would be targeted to Flink
>> developers.
>> > >>> >>> > > > >
>> > >>> >>> > > > > I thought again about the idea of improving the
>> tutorials,
>> > >>> and
>> > >>> >>> I'm no
>> > >>> >>> > > > > longer sure if this would fit SoD well.
>> > >>> >>> > > > > The reason is that creating good tutorials requires a
>> good
>> > >>> >>> portion of
>> > >>> >>> > > > > coding / configuration (creating Docker images, example
>> > >>> programs,
>> > >>> >>> > > etc.).
>> > >>> >>> > > > > Also I'd like to start improving the situation of
>> tutorials
>> > >>> >>> earlier
>> > >>> >>> > > than
>> > >>> >>> > > > > September.
>> > >>> >>> > > > >
>> > >>> >>> > > > > What do others think?
>> > >>> >>> > > > >
>> > >>> >>> > > > > Cheers, Fabian
>> > >>> >>> > > > >
>> > >>> >>> > > > >
>> > >>> >>> > > > > Am Fr., 12. Apr. 2019 um 04:29 Uhr schrieb Jark Wu <
>> > >>> >>> [hidden email]
>> > >>> >>> > >:
>> > >>> >>> > > > >
>> > >>> >>> > > > > > Hi Konstantin, Ken,
>> > >>> >>> > > > > >
>> > >>> >>> > > > > > I agree that Chinese documentation is mainly a
>> > translation.
>> > >>> >>> > > > > >
>> > >>> >>> > > > > > >  Does anyone from the Blink team have input on
>> whether
>> > >>> there
>> > >>> >>> is
>> > >>> >>> > > > > existing,
>> > >>> >>> > > > > > original Chinese documentation which should be
>> translated
>> > >>> to
>> > >>> >>> > English?
>> > >>> >>> > > > > >
>> > >>> >>> > > > > > There is a public Blink documentation [1] which is
>> > English.
>> > >>> >>> > > > > > We have a Blink Chinese documentation in internal,
>> but I
>> > >>> think
>> > >>> >>> we
>> > >>> >>> > > need
>> > >>> >>> > > > to
>> > >>> >>> > > > > > rewrite it in English and restructure it when
>> > contributing
>> > >>> >>> Blink to
>> > >>> >>> > > > > Flink.
>> > >>> >>> > > > > >
>> > >>> >>> > > > > > Regarding the Chinese translation project, I agree
>> with
>> > >>> Ken's
>> > >>> >>> > > opinion.
>> > >>> >>> > > > > >
>> > >>> >>> > > > > > From the point of my translation experience,
>> translation
>> > >>> is a
>> > >>> >>> work
>> > >>> >>> > > that
>> > >>> >>> > > > > > need to understand the original English sentence
>> > correctly
>> > >>> and
>> > >>> >>> then
>> > >>> >>> > > > > express
>> > >>> >>> > > > > > it in Chinese in an easily understandable way. This is
>> > not
>> > >>> a
>> > >>> >>> simple
>> > >>> >>> > > > work
>> > >>> >>> > > > > > that translate word by word. The one we need is not a
>> > >>> >>> "professional
>> > >>> >>> > > > > > translator",
>> > >>> >>> > > > > > but a "technical writer who are familiar with both
>> > >>> >>> languages".  I
>> > >>> >>> > > also
>> > >>> >>> > > > > > agree that the writer who write the initial
>> documentation
>> > >>> has
>> > >>> >>> the
>> > >>> >>> > > > better
>> > >>> >>> > > > > > ability than
>> > >>> >>> > > > > > translator to distill complex technical concepts.
>> > >>> >>> > > > > >
>> > >>> >>> > > > > > [1]: https://flink-china.org/doc/blink
>> > >>> >>> > > > > >
>> > >>> >>> > > > > > On Fri, 12 Apr 2019 at 02:40, Ken Krugler <
>> > >>> >>> > > [hidden email]
>> > >>> >>> > > > >
>> > >>> >>> > > > > > wrote:
>> > >>> >>> > > > > >
>> > >>> >>> > > > > > > Hi Konstantin,
>> > >>> >>> > > > > > >
>> > >>> >>> > > > > > > Comments inline below…
>> > >>> >>> > > > > > >
>> > >>> >>> > > > > > > — Ken
>> > >>> >>> > > > > > >
>> > >>> >>> > > > > > > > On Apr 11, 2019, at 9:05 AM, Konstantin Knauf <
>> > >>> >>> > > > > > [hidden email]>
>> > >>> >>> > > > > > > wrote:
>> > >>> >>> > > > > > > >
>> > >>> >>> > > > > > > > Hi everyone,
>> > >>> >>> > > > > > > >
>> > >>> >>> > > > > > > > I will start going through the registration
>> process
>> > >>> >>> tomorrow
>> > >>> >>> > > (CET).
>> > >>> >>> > > > > > > > Jincheng (cc) reached out to me directly and
>> offered
>> > >>> to be
>> > >>> >>> the
>> > >>> >>> > > > second
>> > >>> >>> > > > > > > > organization administrator. So, we are all set in
>> > that
>> > >>> >>> regard.
>> > >>> >>> > > > > > > >
>> > >>> >>> > > > > > > > In terms of mentors, we now have
>> > >>> >>> > > > > > > >
>> > >>> >>> > > > > > > > * myself
>> > >>> >>> > > > > > > > * Fabian
>> > >>> >>> > > > > > > > * David
>> > >>> >>> > > > > > > > * Stephan
>> > >>> >>> > > > > > > > * Jark (Chinese Translation)
>> > >>> >>> > > > > > > >
>> > >>> >>> > > > > > > > Regarding the Chinese translation project, it is
>> > >>> probably a
>> > >>> >>> > > > question
>> > >>> >>> > > > > of
>> > >>> >>> > > > > > > how
>> > >>> >>> > > > > > > > independent the Chinese version is supposed to
>> be. If
>> > >>> the
>> > >>> >>> > English
>> > >>> >>> > > > > > > > documentation is the ground-truth and the Chinese
>> > >>> >>> documentation
>> > >>> >>> > > is
>> > >>> >>> > > > > > > (mainly)
>> > >>> >>> > > > > > > > a translation, I agree with Stefan. If the Chinese
>> > >>> >>> > documentation
>> > >>> >>> > > is
>> > >>> >>> > > > > > > > supposed to become an independent secondary
>> > >>> documentation,
>> > >>> >>> it
>> > >>> >>> > > could
>> > >>> >>> > > > > be
>> > >>> >>> > > > > > a
>> > >>> >>> > > > > > > > project for a technical writer as well. Has this
>> > >>> questions
>> > >>> >>> > > already
>> > >>> >>> > > > > been
>> > >>> >>> > > > > > > > discussed in the community?
>> > >>> >>> > > > > > >
>> > >>> >>> > > > > > > My understanding is that the Chinese documentation
>> is
>> > >>> going
>> > >>> >>> to
>> > >>> >>> > > mostly
>> > >>> >>> > > > > be
>> > >>> >>> > > > > > a
>> > >>> >>> > > > > > > translation of the English versions.
>> > >>> >>> > > > > > >
>> > >>> >>> > > > > > > Though perhaps, with all of the Blink integration
>> going
>> > >>> on,
>> > >>> >>> the
>> > >>> >>> > > > inverse
>> > >>> >>> > > > > > > could also be true.
>> > >>> >>> > > > > > >
>> > >>> >>> > > > > > > Does anyone from the Blink team have input on
>> whether
>> > >>> there
>> > >>> >>> is
>> > >>> >>> > > > > existing,
>> > >>> >>> > > > > > > original Chinese documentation which should be
>> > >>> translated to
>> > >>> >>> > > English?
>> > >>> >>> > > > > > >
>> > >>> >>> > > > > > > > On Thu, Apr 11, 2019 at 11:34 AM Stephan Ewen <
>> > >>> >>> > [hidden email]>
>> > >>> >>> > > > > > wrote:
>> > >>> >>> > > > > > > >
>> > >>> >>> > > > > > > >> So we have two ideas for docs projects now:
>> > >>> >>> > > > > > > >>
>> > >>> >>> > > > > > > >> (1) Create or rework setup / tutorials / concepts
>> > docs
>> > >>> >>> > > > > > > >> (2) Complete (or advance) the Chinese translation
>> > >>> >>> > > > > > > >>
>> > >>> >>> > > > > > > >> Should we apply for both (and let the SoD
>> committee
>> > >>> select
>> > >>> >>> > > > whichever
>> > >>> >>> > > > > > > they
>> > >>> >>> > > > > > > >> want to sponsor) or select one of them?
>> > >>> >>> > > > > > > >>
>> > >>> >>> > > > > > > >> For project (2), this sounds to me more like a
>> > project
>> > >>> >>> for a
>> > >>> >>> > > > > > > "translator",
>> > >>> >>> > > > > > > >> not a "technical writer". As far as I understand
>> it,
>> > >>> the
>> > >>> >>> big
>> > >>> >>> > > > benefit
>> > >>> >>> > > > > > of
>> > >>> >>> > > > > > > >> having a technical writer is to have someone who
>> can
>> > >>> >>> describe
>> > >>> >>> > > > > > > complicated
>> > >>> >>> > > > > > > >> technical concepts (that engineers describe in
>> > >>> complicated
>> > >>> >>> > > > language)
>> > >>> >>> > > > > > in
>> > >>> >>> > > > > > > an
>> > >>> >>> > > > > > > >> easily understandable way.
>> > >>> >>> > > > > > >
>> > >>> >>> > > > > > > Actually a good Chinese translation of the technical
>> > docs
>> > >>> >>> > requires
>> > >>> >>> > > > > > someone
>> > >>> >>> > > > > > > with many of the same skills. In order for the
>> > >>> translation
>> > >>> >>> to be
>> > >>> >>> > > > > > accurate,
>> > >>> >>> > > > > > > you need someone who understands the concepts of the
>> > >>> >>> underlying
>> > >>> >>> > > > > > technology,
>> > >>> >>> > > > > > > to use appropriate terminology. Though I agree that
>> the
>> > >>> >>> ability
>> > >>> >>> > to
>> > >>> >>> > > > > > distill
>> > >>> >>> > > > > > > complex technical concepts is more important when
>> > writing
>> > >>> >>> initial
>> > >>> >>> > > > > > > documentation.
>> > >>> >>> > > > > > >
>> > >>> >>> > > > > > >
>> > >>> >>> > > > > > > >> On Thu, Apr 11, 2019 at 9:47 AM Fabian Hueske <
>> > >>> >>> > > [hidden email]>
>> > >>> >>> > > > > > > wrote:
>> > >>> >>> > > > > > > >>
>> > >>> >>> > > > > > > >>> Thanks for the clarification Aizhamal!
>> > >>> >>> > > > > > > >>> This is really helpful and will make it a lot
>> > easier
>> > >>> to
>> > >>> >>> > > > coordinate
>> > >>> >>> > > > > > :-)
>> > >>> >>> > > > > > > >>>
>> > >>> >>> > > > > > > >>> As for next steps, I found this email on the
>> > >>> >>> > > > > > [hidden email]
>> > >>> >>> > > > > > > >>> mailing list:
>> > >>> >>> > > > > > > >>>
>> > >>> >>> > > > > > > >>>
>> ==================================================
>> > >>> >>> > > > > > > >>> Hi All,
>> > >>> >>> > > > > > > >>>
>> > >>> >>> > > > > > > >>> As mentioned the applications for the Google
>> Season
>> > >>> of
>> > >>> >>> Docs
>> > >>> >>> > > > opened
>> > >>> >>> > > > > > > today
>> > >>> >>> > > > > > > >>> and I'm working my way through it on behalf of
>> the
>> > >>> ASF.
>> > >>> >>> > > > > > > >>>
>> > >>> >>> > > > > > > >>> If accepted, we will be allocated either one or
>> two
>> > >>> >>> techical
>> > >>> >>> > > > > writers.
>> > >>> >>> > > > > > > >>> Google will also pay the ASF a stipend of $500
>> per
>> > >>> >>> technical
>> > >>> >>> > > > writer
>> > >>> >>> > > > > > > >>> mentored (which I hope can go directly to
>> > >>> fundraising :-)
>> > >>> >>> > > > > > > >>>
>> > >>> >>> > > > > > > >>> Each project that wants to participate must
>> provide
>> > >>> two
>> > >>> >>> > mentors
>> > >>> >>> > > > for
>> > >>> >>> > > > > > > each
>> > >>> >>> > > > > > > >>> documentation project.
>> > >>> >>> > > > > > > >>>
>> > >>> >>> > > > > > > >>> As part of the application process there are a
>> few
>> > >>> things
>> > >>> >>> > that
>> > >>> >>> > > we
>> > >>> >>> > > > > > need
>> > >>> >>> > > > > > > to
>> > >>> >>> > > > > > > >>> setup.
>> > >>> >>> > > > > > > >>>
>> > >>> >>> > > > > > > >>> 1. Season of Docs Page and List of Project Ideas
>> > >>> >>> > > > > > > >>> We need to create a public webpage about Season
>> of
>> > >>> Docs
>> > >>> >>> that
>> > >>> >>> > > > > contains
>> > >>> >>> > > > > > > the
>> > >>> >>> > > > > > > >>> list of project ideas for documentation. I have
>> > >>> created a
>> > >>> >>> > page
>> > >>> >>> > > on
>> > >>> >>> > > > > the
>> > >>> >>> > > > > > > >>> ComDev wiki https://s.apache.org/w4CH  with a
>> > table
>> > >>> for
>> > >>> >>> > > projects
>> > >>> >>> > > > > to
>> > >>> >>> > > > > > > >> record
>> > >>> >>> > > > > > > >>> their ideas.
>> > >>> >>> > > > > > > >>>
>> > >>> >>> > > > > > > >>> 2. Alternative administrator.
>> > >>> >>> > > > > > > >>> I’ve set myself up as the primary admin and
>> Maxim
>> > as
>> > >>> the
>> > >>> >>> > > > > alternative
>> > >>> >>> > > > > > > >> admin
>> > >>> >>> > > > > > > >>> (Maxim, I need to confirm your contact email and
>> > you
>> > >>> will
>> > >>> >>> > also
>> > >>> >>> > > > need
>> > >>> >>> > > > > > to
>> > >>> >>> > > > > > > >>> register as the alternative admin and I will
>> email
>> > >>> you
>> > >>> >>> the
>> > >>> >>> > link
>> > >>> >>> > > > > > > offline)
>> > >>> >>> > > > > > > >>>
>> > >>> >>> > > > > > > >>> 3. Mentors
>> > >>> >>> > > > > > > >>> All mentors from the projects interested in
>> > >>> participating
>> > >>> >>> > must
>> > >>> >>> > > > > > register
>> > >>> >>> > > > > > > >>> individually at the following link :
>> > >>> >>> > > > > > > https://forms.gle/a1x26WQGzURLerv66
>> > >>> >>> > > > > > > >> .
>> > >>> >>> > > > > > > >>>
>> > >>> >>> > > > > > > >>> 4. Application Form: Documentation / Technnial
>> > Writer
>> > >>> >>> > > > Collaboration
>> > >>> >>> > > > > > > >>> There is a section to fill in about experience
>> with
>> > >>> >>> > > documentation
>> > >>> >>> > > > > and
>> > >>> >>> > > > > > > any
>> > >>> >>> > > > > > > >>> previous collaboration with technical writers. I
>> > >>> know a
>> > >>> >>> few
>> > >>> >>> > > > > projects
>> > >>> >>> > > > > > > have
>> > >>> >>> > > > > > > >>> used various tools for documentation - but not
>> sure
>> > >>> >>> about any
>> > >>> >>> > > > > > technical
>> > >>> >>> > > > > > > >>> writing collaboration (so if you know of any
>> then
>> > >>> please
>> > >>> >>> let
>> > >>> >>> > me
>> > >>> >>> > > > > know)
>> > >>> >>> > > > > > > >>>
>> > >>> >>> > > > > > > >>> 5. Application Form: GSoC
>> > >>> >>> > > > > > > >>> There is a section to complete at our
>> participation
>> > >>> in
>> > >>> >>> GSoC.I
>> > >>> >>> > > > > think I
>> > >>> >>> > > > > > > >> have
>> > >>> >>> > > > > > > >>> the details from our application this year so
>> can
>> > >>> follow
>> > >>> >>> up
>> > >>> >>> > > with
>> > >>> >>> > > > > > Maxim
>> > >>> >>> > > > > > > or
>> > >>> >>> > > > > > > >>> Uli about it
>> > >>> >>> > > > > > > >>>
>> > >>> >>> > > > > > > >>> This is all I have at the moment and we have
>> until
>> > >>> the
>> > >>> >>> 23rd
>> > >>> >>> > > April
>> > >>> >>> > > > > > 2019
>> > >>> >>> > > > > > > to
>> > >>> >>> > > > > > > >>> finalise all the application details. Ideally I
>> > want
>> > >>> to
>> > >>> >>> have
>> > >>> >>> > it
>> > >>> >>> > > > > done
>> > >>> >>> > > > > > > well
>> > >>> >>> > > > > > > >>> before then :-)
>> > >>> >>> > > > > > > >>>
>> > >>> >>> > > > > > > >>> Please pass on this information within your
>> various
>> > >>> >>> projects
>> > >>> >>> > > and
>> > >>> >>> > > > as
>> > >>> >>> > > > > > > with
>> > >>> >>> > > > > > > >>> GSoC - I'll see how we can get this information
>> out
>> > >>> to
>> > >>> >>> all
>> > >>> >>> > our
>> > >>> >>> > > > > > project
>> > >>> >>> > > > > > > >>> mailing lists.
>> > >>> >>> > > > > > > >>>
>> > >>> >>> > > > > > > >>> Thanks
>> > >>> >>> > > > > > > >>> Sharan
>> > >>> >>> > > > > > > >>>
>> > >>> >>> > > > > > > >>>
>> ==================================================
>> > >>> >>> > > > > > > >>>
>> > >>> >>> > > > > > > >>> I guess, we would need to follow these steps as
>> > well.
>> > >>> >>> > > > > > > >>>
>> > >>> >>> > > > > > > >>> Best,
>> > >>> >>> > > > > > > >>> Fabian
>> > >>> >>> > > > > > > >>>
>> > >>> >>> > > > > > > >>> Am Do., 11. Apr. 2019 um 05:08 Uhr schrieb Jark
>> Wu
>> > <
>> > >>> >>> > > > > [hidden email]
>> > >>> >>> > > > > > >:
>> > >>> >>> > > > > > > >>>
>> > >>> >>> > > > > > > >>>> Hi Aizhamal,
>> > >>> >>> > > > > > > >>>>
>> > >>> >>> > > > > > > >>>> That's really interesting. We have an ongoing
>> > >>> proposal
>> > >>> >>> for
>> > >>> >>> > > > > > supporting
>> > >>> >>> > > > > > > >>>> Chinese documentation, see FLIP-35 [1].
>> > >>> >>> > > > > > > >>>>
>> > >>> >>> > > > > > > >>>> I think it's a good idea to propose Chinese
>> > >>> translation
>> > >>> >>> as a
>> > >>> >>> > > > > > project.
>> > >>> >>> > > > > > > >>> It's
>> > >>> >>> > > > > > > >>>> a good chance to improve the localization user
>> > >>> >>> experience of
>> > >>> >>> > > > Flink
>> > >>> >>> > > > > > > >>>> documentation.
>> > >>> >>> > > > > > > >>>> I can help as a mentor if we want to submit
>> such a
>> > >>> >>> project.
>> > >>> >>> > > > > > > >>>>
>> > >>> >>> > > > > > > >>>> Thanks,
>> > >>> >>> > > > > > > >>>> Jark Wu
>> > >>> >>> > > > > > > >>>>
>> > >>> >>> > > > > > > >>>> [1]:
>> > >>> >>> > > > > > > >>>>
>> > >>> >>> > > > > > > >>>
>> > >>> >>> > > > > > > >>
>> > >>> >>> > > > > > >
>> > >>> >>> > > > > >
>> > >>> >>> > > > >
>> > >>> >>> > > >
>> > >>> >>> > >
>> > >>> >>> >
>> > >>> >>>
>> > >>>
>> >
>> https://cwiki.apache.org/confluence/display/FLINK/FLIP-35%3A+Support+Chinese+Documents+and+Website
>> > >>> >>> > > > > > > >>>>
>> > >>> >>> > > > > > > >>>> On Thu, 11 Apr 2019 at 02:11, Aizhamal Nurmamat
>> > kyzy
>> > >>> >>> > > > > > > >>>> <[hidden email]> wrote:
>> > >>> >>> > > > > > > >>>>
>> > >>> >>> > > > > > > >>>>> Hello everyone,
>> > >>> >>> > > > > > > >>>>>
>> > >>> >>> > > > > > > >>>>> @Fabian Hueske <[hidden email]> - SoD
>> setup
>> > is
>> > >>> a
>> > >>> >>> little
>> > >>> >>> > > bit
>> > >>> >>> > > > > > > >>> different.
>> > >>> >>> > > > > > > >>>>> The ASF determined that each project would be
>> > >>> allowed
>> > >>> >>> to
>> > >>> >>> > > apply
>> > >>> >>> > > > > > > >>>>> individually[1], rather than applying as a
>> single
>> > >>> large
>> > >>> >>> > > > > > organization.
>> > >>> >>> > > > > > > >>>>>
>> > >>> >>> > > > > > > >>>>> Each project applies as an org, with two
>> > organizers
>> > >>> >>> > > > (administers)
>> > >>> >>> > > > > > and
>> > >>> >>> > > > > > > >> at
>> > >>> >>> > > > > > > >>>>> least two mentors. As Konstantin pointed out,
>> one
>> > >>> can
>> > >>> >>> be
>> > >>> >>> > both
>> > >>> >>> > > > an
>> > >>> >>> > > > > > > >>>>> administer
>> > >>> >>> > > > > > > >>>>> and a mentor. You don't need to coordinate
>> with
>> > >>> other
>> > >>> >>> > > projects
>> > >>> >>> > > > or
>> > >>> >>> > > > > > ASF
>> > >>> >>> > > > > > > >> at
>> > >>> >>> > > > > > > >>>>> all. If accepted to the program, you will
>> receive
>> > >>> >>> project
>> > >>> >>> > > > > proposals
>> > >>> >>> > > > > > > >> from
>> > >>> >>> > > > > > > >>>>> tech writers [2]. You will choose one or two
>> > >>> proposals
>> > >>> >>> that
>> > >>> >>> > > you
>> > >>> >>> > > > > > want
>> > >>> >>> > > > > > > >> to
>> > >>> >>> > > > > > > >>>>> mentor[3].
>> > >>> >>> > > > > > > >>>>>
>> > >>> >>> > > > > > > >>>>> @Ken - as for the language, there isn’t any
>> > >>> >>> limitations in
>> > >>> >>> > > that
>> > >>> >>> > > > > > > >> regard,
>> > >>> >>> > > > > > > >>> so
>> > >>> >>> > > > > > > >>>>> work on the Chinese translation for the
>> website
>> > is
>> > >>> >>> > definitely
>> > >>> >>> > > > an
>> > >>> >>> > > > > > > >>>>> acceptable
>> > >>> >>> > > > > > > >>>>> project.
>> > >>> >>> > > > > > > >>>>>
>> > >>> >>> > > > > > > >>>>> Thanks,
>> > >>> >>> > > > > > > >>>>>
>> > >>> >>> > > > > > > >>>>> Aizhamal
>> > >>> >>> > > > > > > >>>>>
>> > >>> >>> > > > > > > >>>>>
>> > >>> >>> > > > > > > >>>>> [1]
>> > >>> >>> > > > > > > >>>>>
>> > >>> >>> > > > > > > >>>>>
>> > >>> >>> > > > > > > >>>
>> > >>> >>> > > > > > > >>
>> > >>> >>> > > > > > >
>> > >>> >>> > > > > >
>> > >>> >>> > > > >
>> > >>> >>> > > >
>> > >>> >>> > >
>> > >>> >>> >
>> > >>> >>>
>> > >>>
>> >
>> https://lists.apache.org/thread.html/67e1c2e6041cff1e7f198b615407401f032795130e796adfaacf8071@%3Cdev.community.apache.org%3E
>> > >>> >>> > > > > > > >>>>>
>> > >>> >>> > > > > > > >>>>> [2]
>> > >>> https://developers.google.com/season-of-docs/docs/
>> > >>> >>> > > > > > > >>>>>
>> > >>> >>> > > > > > > >>>>> [3]
>> > >>> >>> > > > > > > >>>
>> > >>> >>> > > > > >
>> > >>> >>> > >
>> > >>> >>>
>> > >>>
>> https://developers.google.com/season-of-docs/docs/faq#slot-allocation
>> > >>> >>> > > > > > > >>>>>
>> > >>> >>> > > > > > > >>>>>
>> > >>> >>> > > > > > > >>>>> On Wed, Apr 10, 2019 at 8:32 AM Ken Krugler <
>> > >>> >>> > > > > > > >>> [hidden email]>
>> > >>> >>> > > > > > > >>>>> wrote:
>> > >>> >>> > > > > > > >>>>>
>> > >>> >>> > > > > > > >>>>>> Hi Aizhamal,
>> > >>> >>> > > > > > > >>>>>>
>> > >>> >>> > > > > > > >>>>>> I assume SoD is language-agnostic, so one
>> > possible
>> > >>> >>> project
>> > >>> >>> > > > would
>> > >>> >>> > > > > > be
>> > >>> >>> > > > > > > >> to
>> > >>> >>> > > > > > > >>>>> get
>> > >>> >>> > > > > > > >>>>>> a tech writer for the Chinese versions of
>> all of
>> > >>> the
>> > >>> >>> Flink
>> > >>> >>> > > > > > > >>>>> documentation,
>> > >>> >>> > > > > > > >>>>>> yes?
>> > >>> >>> > > > > > > >>>>>>
>> > >>> >>> > > > > > > >>>>>> Regards,
>> > >>> >>> > > > > > > >>>>>>
>> > >>> >>> > > > > > > >>>>>> — Ken
>> > >>> >>> > > > > > > >>>>>>
>> > >>> >>> > > > > > > >>>>>>> On Apr 5, 2019, at 3:43 PM, Aizhamal
>> Nurmamat
>> > >>> kyzy
>> > >>> >>> > > > > > > >>>>>> <[hidden email]> wrote:
>> > >>> >>> > > > > > > >>>>>>>
>> > >>> >>> > > > > > > >>>>>>> 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
>> > >>> >>> > > > > > >
>> > >>> >>> > > > > > > --------------------------
>> > >>> >>> > > > > > > Ken Krugler
>> > >>> >>> > > > > > > [phone]
>> > >>> >>> > > > > > > http://www.scaleunlimited.com
>> > >>> >>> > > > > > > Custom big data solutions & training
>> > >>> >>> > > > > > > Flink, Solr, Hadoop, Cascading & Cassandra
>> > >>> >>> > > > > > >
>> > >>> >>> > > > > > >
>> > >>> >>> > > > > >
>> > >>> >>> > > > >
>> > >>> >>> > > >
>> > >>> >>> > >
>> > >>> >>> >
>> > >>> >>>
>> > >>> >>
>> > >>> >>
>> > >>> >> --
>> > >>> >>
>> > >>> >> Konstantin Knauf | Solutions Architect
>> > >>> >>
>> > >>> >> [phone]
>> > >>> >>
>> > >>> >> <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
>> > >>> >>
>> > >>> >
>> > >>>
>> > >>> --
>> > >>>
>> > >>> Konstantin Knauf | Solutions Architect
>> > >>>
>> > >>> [phone]
>> > >>>
>> > >>> <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
>> > >>>
>> > >>
>> >
>> > --
>> >
>> > Konstantin Knauf | Solutions Architect
>> >
>> > [phone]
>> >
>> >
>> > Planned Absences: 17.04.2019 - 26.04.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
>> >
>>
>

[Konstantin Knauf-3]

Hi everyone,

I have just submitted our application :)

@Stephan Ewen <[hidden email]>, @David Anderson <[hidden email]>:
Please remember to register as mentor by Tuesday:
https://docs.google.com/forms/d/e/1FAIpQLSe-JjGvaKKGWZOXxrorONhB8qN3mjPrB9ZVkcsntR73Cv_K7g/viewform

Cheers,

Konstantin

On Thu, Apr 18, 2019 at 1:04 PM jincheng sun <[hidden email]>
wrote:

> Hi Konstantin&all,
>
> The  blog post is released, please see
> https://flink.apache.org/news/2019/04/17/sod.html
>
> And I think is better to spread the word by
> https://twitter.com/ApacheFlink,
> but I found that only PMC can manage and publish messages.
>
> Help spread the word here:
> https://twitter.com/sunjincheng121/status/1118831783762481152
>
> Best,
> Jincheng
>
> jincheng sun <[hidden email]> 于2019年4月18日周四 上午11:01写道：
>
> > Thanks Konstantin!
> >
> > I registered as an alternative administrator,  and have had left few
> > comments at the blog post.
> >
> > Best,
> > Jincheng
> >
> > Fabian Hueske <[hidden email]> 于2019年4月18日周四 上午12:36写道：
> >
> >> Thanks Konstantin!
> >>
> >> I registered as a mentor and will have a look at the blog post.
> >>
> >> Best, Fabian
> >>
> >> Am Mi., 17. Apr. 2019 um 18:14 Uhr schrieb Konstantin Knauf <
> >> [hidden email]>:
> >>
> >> > Hi everyone,
> >> >
> >> > a few updates on our application:
> >> >
> >> > 1. As Aizhamal (Thanks!) has suggested I also added the information to
> >> > submit during our application to the Google doc [1] and Fabian added a
> >> > description for the SQL project idea (Thanks!).
> >> >
> >> > 2. I had a quick chat with Fabian offline and we concluded, that the
> >> "Flink
> >> > Internals" project might not be good fit for Season of Docs after all,
> >> > because, we think, the amount of mentoring by core developers that
> >> would be
> >> > necessary to produce such a documentation could not be guaranteed. Any
> >> > opinions?
> >> >
> >> > 3. To submit our application, we need to publish our project ideas
> list.
> >> > For this I have just opened a PR to add a small blog post about Season
> >> of
> >> > Docs [2]. Please have a look and provide feedback.
> >> >
> >> > 4. For mentors (Stephan, Fabian, Jark, David) please complete the
> mentor
> >> > registration [3] by next Tuesday (*Application Deadline*)
> >> >
> >> > Cheers,
> >> >
> >> > Konstantin
> >> >
> >> > [1]
> >> >
> >> >
> >>
> https://docs.google.com/document/d/1Up53jNsLztApn-mP76AB6xWUVGt3nwS9p6xQTiceKXo/edit?usp=sharing
> >> > [2] https://github.com/apache/flink-web/pull/202
> >> > [3]
> >> >
> >> >
> >>
> https://docs.google.com/forms/d/e/1FAIpQLSe-JjGvaKKGWZOXxrorONhB8qN3mjPrB9ZVkcsntR73Cv_K7g/viewform
> >> >
> >> > On Mon, Apr 15, 2019 at 9:12 PM Aizhamal Nurmamat kyzy <
> >> > [hidden email]>
> >> > wrote:
> >> >
> >> > > +Konstantin Knauf <[hidden email]> this is looking good,
> >> > thanks
> >> > > for sharing!
> >> > >
> >> > > I also created a similar doc for Apache Airflow [1]. It is a bit
> >> messy,
> >> > > but it has questions from the application form that you can work
> with.
> >> > >
> >> > > Cheers,
> >> > > Aizhamal
> >> > >
> >> > > [1]
> >> > >
> >> >
> >>
> https://docs.google.com/document/d/1HoL_yjNYiTAP9IxSlhx3EUnPFU4l9WOT9EnwBZjCZo0/edit#
> >> > >
> >> > >
> >> > > On Mon, Apr 15, 2019 at 2:24 AM Robert Metzger <[hidden email]
> >
> >> > > wrote:
> >> > >
> >> > >> Hi all,
> >> > >> I'm very happy to see this project happening!
> >> > >>
> >> > >> Thank you for the proposal Konstantin! One idea for the "related
> >> > >> material": we could also link to talks or blog posts about
> concepts /
> >> > >> monitoring / operations. Potential writers could feel overwhelmed
> by
> >> our
> >> > >> demand for improvements, without any additional material.
> >> > >>
> >> > >>
> >> > >> On Mon, Apr 15, 2019 at 10:16 AM Konstantin Knauf <
> >> > >> [hidden email]> wrote:
> >> > >>
> >> > >>> Hi everyone,
> >> > >>>
> >> > >>> thanks @Aizhamal Nurmamat kyzy <[hidden email]>. As we only
> >> have
> >> > >>> one
> >> > >>> week left until the application deadline, I went ahead and
> created a
> >> > >>> document for the project ideas [1]. I have added the description
> for
> >> > the
> >> > >>> "stream processing concepts" as well as the "deployment &
> operations
> >> > >>> documentation" project idea. Please let me know what you think,
> >> edit &
> >> > >>> comment. We also need descriptions for the other two projects
> (Table
> >> > >>> API/SQL & Flink Internals). @Fabian/@Jark/@Stephan can you chime
> in?
> >> > >>>
> >> > >>> Any more project ideas?
> >> > >>>
> >> > >>> Best,
> >> > >>>
> >> > >>> Konstantin
> >> > >>>
> >> > >>>
> >> > >>> [1]
> >> > >>>
> >> > >>>
> >> >
> >>
> https://docs.google.com/document/d/1Up53jNsLztApn-mP76AB6xWUVGt3nwS9p6xQTiceKXo/edit?usp=sharing
> >> > >>>
> >> > >>>
> >> > >>>
> >> > >>> On Fri, Apr 12, 2019 at 6:50 PM Aizhamal Nurmamat kyzy <
> >> > >>> [hidden email]>
> >> > >>> wrote:
> >> > >>>
> >> > >>> > Hello everyone,
> >> > >>> >
> >> > >>> > @Konstantin Knauf <[hidden email]> - yes, you are
> >> correct.
> >> > >>> > Between steps 1 and 2 though, the open source organization, in
> >> this
> >> > >>> case
> >> > >>> > Flink, has to be selected by SoD as one of the participating
> orgs
> >> > >>> *fingers
> >> > >>> > crossed*.
> >> > >>> >
> >> > >>> > One tip about organizing ideas is that you want to communicate
> >> > >>> potential
> >> > >>> > projects to the tech writers that are applying. Just make sure
> the
> >> > >>> scope of
> >> > >>> > the project is clear to them. The SoD wants to set up the tech
> >> > writers
> >> > >>> for
> >> > >>> > success by making sure the work can be done in the allotted
> time.
> >> > >>> >
> >> > >>> > Hope it helps.
> >> > >>> >
> >> > >>> > Aizhamal
> >> > >>> >
> >> > >>> >
> >> > >>> >
> >> > >>> > On Fri, Apr 12, 2019 at 7:37 AM Konstantin Knauf <
> >> > >>> [hidden email]>
> >> > >>> > wrote:
> >> > >>> >
> >> > >>> >> Hi all,
> >> > >>> >>
> >> > >>> >> I read through the SoD documentation again, and now I think, it
> >> > would
> >> > >>> >> actually make sense to split (1) up into multiple project
> ideas.
> >> Let
> >> > >>> me
> >> > >>> >> summarize the overall process:
> >> > >>> >>
> >> > >>> >> 1. We create & publish a list of project ideas, e.g. in a blog
> >> post.
> >> > >>> >> (This can be any number of ideas.)
> >> > >>> >> 2. Potential technical writers look at our list of ideas and
> >> sent a
> >> > >>> >> proposal for a particular project to Google. During that time
> >> they
> >> > can
> >> > >>> >> reach out to us for clarification.
> >> > >>> >> 3. Google forwards all proposals for our project ideas to us
> and
> >> we
> >> > >>> sent
> >> > >>> >> back a prioritized list of proposals, which we would like to
> >> accept.
> >> > >>> >> 4. Of all these proposals, Google accepts 50 proposals for SoD
> >> 2019.
> >> > >>> Per
> >> > >>> >> organization Google will only accept a maximum of two
> proposals.
> >> > >>> >>
> >> > >>> >> @Aizhamal Nurmamat kyzy <[hidden email]> Please correct
> me!
> >> > >>> >>
> >> > >>> >> For me this means we should splits this up in a way, that each
> >> > >>> project is
> >> > >>> >> a) still relevant in September b) makes sense as a 3 month
> >> project.
> >> > >>> Based
> >> > >>> >> on the ideas we have right now these could for example be:
> >> > >>> >>
> >> > >>> >> (I) Rework/Extract/Improve the documentation of stream
> processing
> >> > >>> concepts
> >> > >>> >> (II) Improve & extend Apache Flink's documentation for
> >> deployment,
> >> > >>> >> operations (incl. configuration)
> >> > >>> >> (III) Add documentation for Flink internals
> >> > >>> >> (IV) Rework Table API / SQL documentation
> >> > >>> >>
> >> > >>> >> We would then get proposals potentially for all of these topics
> >> and
> >> > >>> could
> >> > >>> >> decide which of these proposals, we would sent back to Google.
> My
> >> > >>> feeling
> >> > >>> >> is that a technical writer could easily spent three months on
> >> any of
> >> > >>> these
> >> > >>> >> projects. What do others think? Any other project ideas?
> >> > >>> >>
> >> > >>> >> Cheers,
> >> > >>> >>
> >> > >>> >> Konstantin
> >> > >>> >>
> >> > >>> >>
> >> > >>> >>
> >> > >>> >>
> >> > >>> >> On Fri, Apr 12, 2019 at 1:47 PM Jark Wu <[hidden email]>
> >> wrote:
> >> > >>> >>
> >> > >>> >>> Hi all,
> >> > >>> >>>
> >> > >>> >>> I'm fine with only preparing the first proposal. I think it's
> >> > >>> reasonable
> >> > >>> >>> because the first proposal is more attractive
> >> > >>> >>> and maybe there is not enough Chinese writer. We can focus on
> >> one
> >> > >>> project
> >> > >>> >>> to come up with a concrete and
> >> > >>> >>> attractive project plan.
> >> > >>> >>>
> >> > >>> >>> One possible subproject could be rework Table SQL docs.
> >> > >>> >>> (1). Improve concepts in Table SQL.
> >> > >>> >>> (2). A more detailed introduction of built-in functions,
> >> currently
> >> > we
> >> > >>> >>> only
> >> > >>> >>> have a simple explanation for each function.
> >> > >>> >>>       We should add more descriptions, especially more
> concrete
> >> > >>> examples,
> >> > >>> >>> and maybe some notes. We can take
> >> > >>> >>>       MySQL doc [1] as a reference.
> >> > >>> >>> (3). As Flink SQL is evolving rapidly and features from Blink
> is
> >> > >>> being
> >> > >>> >>> merged,  for example, SQL DDL, Hive integration,
> >> > >>> >>>       Python Table API, Interactive Programing, SQL
> optimization
> >> > and
> >> > >>> >>> tuning, etc... We can redesign the doc structure of
> >> > >>> >>>       Table SQL in a higher vision.
> >> > >>> >>>
> >> > >>> >>> Cheers,
> >> > >>> >>> Jark
> >> > >>> >>>
> >> > >>> >>> [1]:
> >> > >>> >>>
> >> > >>> >>>
> >> > >>>
> >> >
> >>
> https://dev.mysql.com/doc/refman/5.7/en/string-functions.html#function_bin
> >> > >>> >>>
> >> > >>> >>>
> >> > >>> >>>
> >> > >>> >>> On Fri, 12 Apr 2019 at 18:19, jincheng sun <
> >> > [hidden email]
> >> > >>> >
> >> > >>> >>> wrote:
> >> > >>> >>>
> >> > >>> >>> > I am honored to have the opportunity to do a second
> >> organization
> >> > >>> >>> > administrator‘s works!
> >> > >>> >>> >
> >> > >>> >>> > It seems that one project and multiple projects have their
> own
> >> > >>> >>> advantages.
> >> > >>> >>> >
> >> > >>> >>> > My understanding is that even if we only have one project,
> we
> >> > also
> >> > >>> can
> >> > >>> >>> have
> >> > >>> >>> > multiple mentors and recruit enough writers.
> >> > >>> >>> >
> >> > >>> >>> > Fabian Hueske <[hidden email]> 于2019年4月12日周五 下午5:57写道：
> >> > >>> >>> >
> >> > >>> >>> > > Yes, I think we would get at most one project accepted.
> >> > >>> >>> > > Having all options in a rather generic proposal gives us
> the
> >> > most
> >> > >>> >>> > > flexibility to decide what to work on once the proposal is
> >> > >>> accepted.
> >> > >>> >>> > > On the other hand, a more concrete proposal might look
> more
> >> > >>> >>> attractive
> >> > >>> >>> > for
> >> > >>> >>> > > candidates.
> >> > >>> >>> > > I'm fine either way, but my gut feeling is that a well
> >> scoped
> >> > >>> >>> proposal
> >> > >>> >>> > > gives better changes of finding a writer (which might be
> the
> >> > >>> biggest
> >> > >>> >>> > > challenge).
> >> > >>> >>> > >
> >> > >>> >>> > > Am Fr., 12. Apr. 2019 um 11:39 Uhr schrieb Stephan Ewen <
> >> > >>> >>> > [hidden email]
> >> > >>> >>> > > >:
> >> > >>> >>> > >
> >> > >>> >>> > > > I would suggest to make one proposal and have the
> >> subsections
> >> > >>> only
> >> > >>> >>> in
> >> > >>> >>> > the
> >> > >>> >>> > > > project plan.
> >> > >>> >>> > > > My understanding is that we need to indicate priorities
> >> > between
> >> > >>> >>> > proposals
> >> > >>> >>> > > > and might get only one, so it would be good to not
> >> subdivide.
> >> > >>> >>> > > >
> >> > >>> >>> > > > On Fri, Apr 12, 2019 at 9:58 AM Fabian Hueske <
> >> > >>> [hidden email]>
> >> > >>> >>> > wrote:
> >> > >>> >>> > > >
> >> > >>> >>> > > > > Hi everyone,
> >> > >>> >>> > > > >
> >> > >>> >>> > > > > I think we can split the first project that Stephan
> >> > proposed
> >> > >>> into
> >> > >>> >>> > > smaller
> >> > >>> >>> > > > > ones:
> >> > >>> >>> > > > >
> >> > >>> >>> > > > > > (1) Create or rework setup / tutorials / concepts
> docs
> >> > >>> >>> > > > > > (2) Complete (or advance) the Chinese translation
> >> > >>> >>> > > > >
> >> > >>> >>> > > > > 1.1 Improving (extracting) the documentation of stream
> >> > >>> processing
> >> > >>> >>> > > > concepts:
> >> > >>> >>> > > > > Event-time, Timers, State, State Backends,
> >> Checkpointing,
> >> > >>> >>> Savepoints
> >> > >>> >>> > > > > Right now, the relevant information is scattered
> across
> >> > >>> several
> >> > >>> >>> pages
> >> > >>> >>> > > and
> >> > >>> >>> > > > > mixed with the implementation / APIs / configuration
> >> > options.
> >> > >>> >>> > > > >
> >> > >>> >>> > > > > 1.2 Improving & extending the documentation of
> >> deployments
> >> > >>> >>> > > > >
> >> > >>> >>> > > > > 1.3 Adding documentation in the internals: Distributed
> >> > >>> >>> architecture,
> >> > >>> >>> > > > > recovery, operators, job translation, execution, etc.
> >> > >>> >>> > > > > This documentation would be targeted to Flink
> >> developers.
> >> > >>> >>> > > > >
> >> > >>> >>> > > > > I thought again about the idea of improving the
> >> tutorials,
> >> > >>> and
> >> > >>> >>> I'm no
> >> > >>> >>> > > > > longer sure if this would fit SoD well.
> >> > >>> >>> > > > > The reason is that creating good tutorials requires a
> >> good
> >> > >>> >>> portion of
> >> > >>> >>> > > > > coding / configuration (creating Docker images,
> example
> >> > >>> programs,
> >> > >>> >>> > > etc.).
> >> > >>> >>> > > > > Also I'd like to start improving the situation of
> >> tutorials
> >> > >>> >>> earlier
> >> > >>> >>> > > than
> >> > >>> >>> > > > > September.
> >> > >>> >>> > > > >
> >> > >>> >>> > > > > What do others think?
> >> > >>> >>> > > > >
> >> > >>> >>> > > > > Cheers, Fabian
> >> > >>> >>> > > > >
> >> > >>> >>> > > > >
> >> > >>> >>> > > > > Am Fr., 12. Apr. 2019 um 04:29 Uhr schrieb Jark Wu <
> >> > >>> >>> [hidden email]
> >> > >>> >>> > >:
> >> > >>> >>> > > > >
> >> > >>> >>> > > > > > Hi Konstantin, Ken,
> >> > >>> >>> > > > > >
> >> > >>> >>> > > > > > I agree that Chinese documentation is mainly a
> >> > translation.
> >> > >>> >>> > > > > >
> >> > >>> >>> > > > > > >  Does anyone from the Blink team have input on
> >> whether
> >> > >>> there
> >> > >>> >>> is
> >> > >>> >>> > > > > existing,
> >> > >>> >>> > > > > > original Chinese documentation which should be
> >> translated
> >> > >>> to
> >> > >>> >>> > English?
> >> > >>> >>> > > > > >
> >> > >>> >>> > > > > > There is a public Blink documentation [1] which is
> >> > English.
> >> > >>> >>> > > > > > We have a Blink Chinese documentation in internal,
> >> but I
> >> > >>> think
> >> > >>> >>> we
> >> > >>> >>> > > need
> >> > >>> >>> > > > to
> >> > >>> >>> > > > > > rewrite it in English and restructure it when
> >> > contributing
> >> > >>> >>> Blink to
> >> > >>> >>> > > > > Flink.
> >> > >>> >>> > > > > >
> >> > >>> >>> > > > > > Regarding the Chinese translation project, I agree
> >> with
> >> > >>> Ken's
> >> > >>> >>> > > opinion.
> >> > >>> >>> > > > > >
> >> > >>> >>> > > > > > From the point of my translation experience,
> >> translation
> >> > >>> is a
> >> > >>> >>> work
> >> > >>> >>> > > that
> >> > >>> >>> > > > > > need to understand the original English sentence
> >> > correctly
> >> > >>> and
> >> > >>> >>> then
> >> > >>> >>> > > > > express
> >> > >>> >>> > > > > > it in Chinese in an easily understandable way. This
> is
> >> > not
> >> > >>> a
> >> > >>> >>> simple
> >> > >>> >>> > > > work
> >> > >>> >>> > > > > > that translate word by word. The one we need is not
> a
> >> > >>> >>> "professional
> >> > >>> >>> > > > > > translator",
> >> > >>> >>> > > > > > but a "technical writer who are familiar with both
> >> > >>> >>> languages".  I
> >> > >>> >>> > > also
> >> > >>> >>> > > > > > agree that the writer who write the initial
> >> documentation
> >> > >>> has
> >> > >>> >>> the
> >> > >>> >>> > > > better
> >> > >>> >>> > > > > > ability than
> >> > >>> >>> > > > > > translator to distill complex technical concepts.
> >> > >>> >>> > > > > >
> >> > >>> >>> > > > > > [1]: https://flink-china.org/doc/blink
> >> > >>> >>> > > > > >
> >> > >>> >>> > > > > > On Fri, 12 Apr 2019 at 02:40, Ken Krugler <
> >> > >>> >>> > > [hidden email]
> >> > >>> >>> > > > >
> >> > >>> >>> > > > > > wrote:
> >> > >>> >>> > > > > >
> >> > >>> >>> > > > > > > Hi Konstantin,
> >> > >>> >>> > > > > > >
> >> > >>> >>> > > > > > > Comments inline below…
> >> > >>> >>> > > > > > >
> >> > >>> >>> > > > > > > — Ken
> >> > >>> >>> > > > > > >
> >> > >>> >>> > > > > > > > On Apr 11, 2019, at 9:05 AM, Konstantin Knauf <
> >> > >>> >>> > > > > > [hidden email]>
> >> > >>> >>> > > > > > > wrote:
> >> > >>> >>> > > > > > > >
> >> > >>> >>> > > > > > > > Hi everyone,
> >> > >>> >>> > > > > > > >
> >> > >>> >>> > > > > > > > I will start going through the registration
> >> process
> >> > >>> >>> tomorrow
> >> > >>> >>> > > (CET).
> >> > >>> >>> > > > > > > > Jincheng (cc) reached out to me directly and
> >> offered
> >> > >>> to be
> >> > >>> >>> the
> >> > >>> >>> > > > second
> >> > >>> >>> > > > > > > > organization administrator. So, we are all set
> in
> >> > that
> >> > >>> >>> regard.
> >> > >>> >>> > > > > > > >
> >> > >>> >>> > > > > > > > In terms of mentors, we now have
> >> > >>> >>> > > > > > > >
> >> > >>> >>> > > > > > > > * myself
> >> > >>> >>> > > > > > > > * Fabian
> >> > >>> >>> > > > > > > > * David
> >> > >>> >>> > > > > > > > * Stephan
> >> > >>> >>> > > > > > > > * Jark (Chinese Translation)
> >> > >>> >>> > > > > > > >
> >> > >>> >>> > > > > > > > Regarding the Chinese translation project, it is
> >> > >>> probably a
> >> > >>> >>> > > > question
> >> > >>> >>> > > > > of
> >> > >>> >>> > > > > > > how
> >> > >>> >>> > > > > > > > independent the Chinese version is supposed to
> >> be. If
> >> > >>> the
> >> > >>> >>> > English
> >> > >>> >>> > > > > > > > documentation is the ground-truth and the
> Chinese
> >> > >>> >>> documentation
> >> > >>> >>> > > is
> >> > >>> >>> > > > > > > (mainly)
> >> > >>> >>> > > > > > > > a translation, I agree with Stefan. If the
> Chinese
> >> > >>> >>> > documentation
> >> > >>> >>> > > is
> >> > >>> >>> > > > > > > > supposed to become an independent secondary
> >> > >>> documentation,
> >> > >>> >>> it
> >> > >>> >>> > > could
> >> > >>> >>> > > > > be
> >> > >>> >>> > > > > > a
> >> > >>> >>> > > > > > > > project for a technical writer as well. Has this
> >> > >>> questions
> >> > >>> >>> > > already
> >> > >>> >>> > > > > been
> >> > >>> >>> > > > > > > > discussed in the community?
> >> > >>> >>> > > > > > >
> >> > >>> >>> > > > > > > My understanding is that the Chinese documentation
> >> is
> >> > >>> going
> >> > >>> >>> to
> >> > >>> >>> > > mostly
> >> > >>> >>> > > > > be
> >> > >>> >>> > > > > > a
> >> > >>> >>> > > > > > > translation of the English versions.
> >> > >>> >>> > > > > > >
> >> > >>> >>> > > > > > > Though perhaps, with all of the Blink integration
> >> going
> >> > >>> on,
> >> > >>> >>> the
> >> > >>> >>> > > > inverse
> >> > >>> >>> > > > > > > could also be true.
> >> > >>> >>> > > > > > >
> >> > >>> >>> > > > > > > Does anyone from the Blink team have input on
> >> whether
> >> > >>> there
> >> > >>> >>> is
> >> > >>> >>> > > > > existing,
> >> > >>> >>> > > > > > > original Chinese documentation which should be
> >> > >>> translated to
> >> > >>> >>> > > English?
> >> > >>> >>> > > > > > >
> >> > >>> >>> > > > > > > > On Thu, Apr 11, 2019 at 11:34 AM Stephan Ewen <
> >> > >>> >>> > [hidden email]>
> >> > >>> >>> > > > > > wrote:
> >> > >>> >>> > > > > > > >
> >> > >>> >>> > > > > > > >> So we have two ideas for docs projects now:
> >> > >>> >>> > > > > > > >>
> >> > >>> >>> > > > > > > >> (1) Create or rework setup / tutorials /
> concepts
> >> > docs
> >> > >>> >>> > > > > > > >> (2) Complete (or advance) the Chinese
> translation
> >> > >>> >>> > > > > > > >>
> >> > >>> >>> > > > > > > >> Should we apply for both (and let the SoD
> >> committee
> >> > >>> select
> >> > >>> >>> > > > whichever
> >> > >>> >>> > > > > > > they
> >> > >>> >>> > > > > > > >> want to sponsor) or select one of them?
> >> > >>> >>> > > > > > > >>
> >> > >>> >>> > > > > > > >> For project (2), this sounds to me more like a
> >> > project
> >> > >>> >>> for a
> >> > >>> >>> > > > > > > "translator",
> >> > >>> >>> > > > > > > >> not a "technical writer". As far as I
> understand
> >> it,
> >> > >>> the
> >> > >>> >>> big
> >> > >>> >>> > > > benefit
> >> > >>> >>> > > > > > of
> >> > >>> >>> > > > > > > >> having a technical writer is to have someone
> who
> >> can
> >> > >>> >>> describe
> >> > >>> >>> > > > > > > complicated
> >> > >>> >>> > > > > > > >> technical concepts (that engineers describe in
> >> > >>> complicated
> >> > >>> >>> > > > language)
> >> > >>> >>> > > > > > in
> >> > >>> >>> > > > > > > an
> >> > >>> >>> > > > > > > >> easily understandable way.
> >> > >>> >>> > > > > > >
> >> > >>> >>> > > > > > > Actually a good Chinese translation of the
> technical
> >> > docs
> >> > >>> >>> > requires
> >> > >>> >>> > > > > > someone
> >> > >>> >>> > > > > > > with many of the same skills. In order for the
> >> > >>> translation
> >> > >>> >>> to be
> >> > >>> >>> > > > > > accurate,
> >> > >>> >>> > > > > > > you need someone who understands the concepts of
> the
> >> > >>> >>> underlying
> >> > >>> >>> > > > > > technology,
> >> > >>> >>> > > > > > > to use appropriate terminology. Though I agree
> that
> >> the
> >> > >>> >>> ability
> >> > >>> >>> > to
> >> > >>> >>> > > > > > distill
> >> > >>> >>> > > > > > > complex technical concepts is more important when
> >> > writing
> >> > >>> >>> initial
> >> > >>> >>> > > > > > > documentation.
> >> > >>> >>> > > > > > >
> >> > >>> >>> > > > > > >
> >> > >>> >>> > > > > > > >> On Thu, Apr 11, 2019 at 9:47 AM Fabian Hueske <
> >> > >>> >>> > > [hidden email]>
> >> > >>> >>> > > > > > > wrote:
> >> > >>> >>> > > > > > > >>
> >> > >>> >>> > > > > > > >>> Thanks for the clarification Aizhamal!
> >> > >>> >>> > > > > > > >>> This is really helpful and will make it a lot
> >> > easier
> >> > >>> to
> >> > >>> >>> > > > coordinate
> >> > >>> >>> > > > > > :-)
> >> > >>> >>> > > > > > > >>>
> >> > >>> >>> > > > > > > >>> As for next steps, I found this email on the
> >> > >>> >>> > > > > > [hidden email]
> >> > >>> >>> > > > > > > >>> mailing list:
> >> > >>> >>> > > > > > > >>>
> >> > >>> >>> > > > > > > >>>
> >> ==================================================
> >> > >>> >>> > > > > > > >>> Hi All,
> >> > >>> >>> > > > > > > >>>
> >> > >>> >>> > > > > > > >>> As mentioned the applications for the Google
> >> Season
> >> > >>> of
> >> > >>> >>> Docs
> >> > >>> >>> > > > opened
> >> > >>> >>> > > > > > > today
> >> > >>> >>> > > > > > > >>> and I'm working my way through it on behalf of
> >> the
> >> > >>> ASF.
> >> > >>> >>> > > > > > > >>>
> >> > >>> >>> > > > > > > >>> If accepted, we will be allocated either one
> or
> >> two
> >> > >>> >>> techical
> >> > >>> >>> > > > > writers.
> >> > >>> >>> > > > > > > >>> Google will also pay the ASF a stipend of $500
> >> per
> >> > >>> >>> technical
> >> > >>> >>> > > > writer
> >> > >>> >>> > > > > > > >>> mentored (which I hope can go directly to
> >> > >>> fundraising :-)
> >> > >>> >>> > > > > > > >>>
> >> > >>> >>> > > > > > > >>> Each project that wants to participate must
> >> provide
> >> > >>> two
> >> > >>> >>> > mentors
> >> > >>> >>> > > > for
> >> > >>> >>> > > > > > > each
> >> > >>> >>> > > > > > > >>> documentation project.
> >> > >>> >>> > > > > > > >>>
> >> > >>> >>> > > > > > > >>> As part of the application process there are a
> >> few
> >> > >>> things
> >> > >>> >>> > that
> >> > >>> >>> > > we
> >> > >>> >>> > > > > > need
> >> > >>> >>> > > > > > > to
> >> > >>> >>> > > > > > > >>> setup.
> >> > >>> >>> > > > > > > >>>
> >> > >>> >>> > > > > > > >>> 1. Season of Docs Page and List of Project
> Ideas
> >> > >>> >>> > > > > > > >>> We need to create a public webpage about
> Season
> >> of
> >> > >>> Docs
> >> > >>> >>> that
> >> > >>> >>> > > > > contains
> >> > >>> >>> > > > > > > the
> >> > >>> >>> > > > > > > >>> list of project ideas for documentation. I
> have
> >> > >>> created a
> >> > >>> >>> > page
> >> > >>> >>> > > on
> >> > >>> >>> > > > > the
> >> > >>> >>> > > > > > > >>> ComDev wiki https://s.apache.org/w4CH  with a
> >> > table
> >> > >>> for
> >> > >>> >>> > > projects
> >> > >>> >>> > > > > to
> >> > >>> >>> > > > > > > >> record
> >> > >>> >>> > > > > > > >>> their ideas.
> >> > >>> >>> > > > > > > >>>
> >> > >>> >>> > > > > > > >>> 2. Alternative administrator.
> >> > >>> >>> > > > > > > >>> I’ve set myself up as the primary admin and
> >> Maxim
> >> > as
> >> > >>> the
> >> > >>> >>> > > > > alternative
> >> > >>> >>> > > > > > > >> admin
> >> > >>> >>> > > > > > > >>> (Maxim, I need to confirm your contact email
> and
> >> > you
> >> > >>> will
> >> > >>> >>> > also
> >> > >>> >>> > > > need
> >> > >>> >>> > > > > > to
> >> > >>> >>> > > > > > > >>> register as the alternative admin and I will
> >> email
> >> > >>> you
> >> > >>> >>> the
> >> > >>> >>> > link
> >> > >>> >>> > > > > > > offline)
> >> > >>> >>> > > > > > > >>>
> >> > >>> >>> > > > > > > >>> 3. Mentors
> >> > >>> >>> > > > > > > >>> All mentors from the projects interested in
> >> > >>> participating
> >> > >>> >>> > must
> >> > >>> >>> > > > > > register
> >> > >>> >>> > > > > > > >>> individually at the following link :
> >> > >>> >>> > > > > > > https://forms.gle/a1x26WQGzURLerv66
> >> > >>> >>> > > > > > > >> .
> >> > >>> >>> > > > > > > >>>
> >> > >>> >>> > > > > > > >>> 4. Application Form: Documentation / Technnial
> >> > Writer
> >> > >>> >>> > > > Collaboration
> >> > >>> >>> > > > > > > >>> There is a section to fill in about experience
> >> with
> >> > >>> >>> > > documentation
> >> > >>> >>> > > > > and
> >> > >>> >>> > > > > > > any
> >> > >>> >>> > > > > > > >>> previous collaboration with technical
> writers. I
> >> > >>> know a
> >> > >>> >>> few
> >> > >>> >>> > > > > projects
> >> > >>> >>> > > > > > > have
> >> > >>> >>> > > > > > > >>> used various tools for documentation - but not
> >> sure
> >> > >>> >>> about any
> >> > >>> >>> > > > > > technical
> >> > >>> >>> > > > > > > >>> writing collaboration (so if you know of any
> >> then
> >> > >>> please
> >> > >>> >>> let
> >> > >>> >>> > me
> >> > >>> >>> > > > > know)
> >> > >>> >>> > > > > > > >>>
> >> > >>> >>> > > > > > > >>> 5. Application Form: GSoC
> >> > >>> >>> > > > > > > >>> There is a section to complete at our
> >> participation
> >> > >>> in
> >> > >>> >>> GSoC.I
> >> > >>> >>> > > > > think I
> >> > >>> >>> > > > > > > >> have
> >> > >>> >>> > > > > > > >>> the details from our application this year so
> >> can
> >> > >>> follow
> >> > >>> >>> up
> >> > >>> >>> > > with
> >> > >>> >>> > > > > > Maxim
> >> > >>> >>> > > > > > > or
> >> > >>> >>> > > > > > > >>> Uli about it
> >> > >>> >>> > > > > > > >>>
> >> > >>> >>> > > > > > > >>> This is all I have at the moment and we have
> >> until
> >> > >>> the
> >> > >>> >>> 23rd
> >> > >>> >>> > > April
> >> > >>> >>> > > > > > 2019
> >> > >>> >>> > > > > > > to
> >> > >>> >>> > > > > > > >>> finalise all the application details. Ideally
> I
> >> > want
> >> > >>> to
> >> > >>> >>> have
> >> > >>> >>> > it
> >> > >>> >>> > > > > done
> >> > >>> >>> > > > > > > well
> >> > >>> >>> > > > > > > >>> before then :-)
> >> > >>> >>> > > > > > > >>>
> >> > >>> >>> > > > > > > >>> Please pass on this information within your
> >> various
> >> > >>> >>> projects
> >> > >>> >>> > > and
> >> > >>> >>> > > > as
> >> > >>> >>> > > > > > > with
> >> > >>> >>> > > > > > > >>> GSoC - I'll see how we can get this
> information
> >> out
> >> > >>> to
> >> > >>> >>> all
> >> > >>> >>> > our
> >> > >>> >>> > > > > > project
> >> > >>> >>> > > > > > > >>> mailing lists.
> >> > >>> >>> > > > > > > >>>
> >> > >>> >>> > > > > > > >>> Thanks
> >> > >>> >>> > > > > > > >>> Sharan
> >> > >>> >>> > > > > > > >>>
> >> > >>> >>> > > > > > > >>>
> >> ==================================================
> >> > >>> >>> > > > > > > >>>
> >> > >>> >>> > > > > > > >>> I guess, we would need to follow these steps
> as
> >> > well.
> >> > >>> >>> > > > > > > >>>
> >> > >>> >>> > > > > > > >>> Best,
> >> > >>> >>> > > > > > > >>> Fabian
> >> > >>> >>> > > > > > > >>>
> >> > >>> >>> > > > > > > >>> Am Do., 11. Apr. 2019 um 05:08 Uhr schrieb
> Jark
> >> Wu
> >> > <
> >> > >>> >>> > > > > [hidden email]
> >> > >>> >>> > > > > > >:
> >> > >>> >>> > > > > > > >>>
> >> > >>> >>> > > > > > > >>>> Hi Aizhamal,
> >> > >>> >>> > > > > > > >>>>
> >> > >>> >>> > > > > > > >>>> That's really interesting. We have an ongoing
> >> > >>> proposal
> >> > >>> >>> for
> >> > >>> >>> > > > > > supporting
> >> > >>> >>> > > > > > > >>>> Chinese documentation, see FLIP-35 [1].
> >> > >>> >>> > > > > > > >>>>
> >> > >>> >>> > > > > > > >>>> I think it's a good idea to propose Chinese
> >> > >>> translation
> >> > >>> >>> as a
> >> > >>> >>> > > > > > project.
> >> > >>> >>> > > > > > > >>> It's
> >> > >>> >>> > > > > > > >>>> a good chance to improve the localization
> user
> >> > >>> >>> experience of
> >> > >>> >>> > > > Flink
> >> > >>> >>> > > > > > > >>>> documentation.
> >> > >>> >>> > > > > > > >>>> I can help as a mentor if we want to submit
> >> such a
> >> > >>> >>> project.
> >> > >>> >>> > > > > > > >>>>
> >> > >>> >>> > > > > > > >>>> Thanks,
> >> > >>> >>> > > > > > > >>>> Jark Wu
> >> > >>> >>> > > > > > > >>>>
> >> > >>> >>> > > > > > > >>>> [1]:
> >> > >>> >>> > > > > > > >>>>
> >> > >>> >>> > > > > > > >>>
> >> > >>> >>> > > > > > > >>
> >> > >>> >>> > > > > > >
> >> > >>> >>> > > > > >
> >> > >>> >>> > > > >
> >> > >>> >>> > > >
> >> > >>> >>> > >
> >> > >>> >>> >
> >> > >>> >>>
> >> > >>>
> >> >
> >>
> https://cwiki.apache.org/confluence/display/FLINK/FLIP-35%3A+Support+Chinese+Documents+and+Website
> >> > >>> >>> > > > > > > >>>>
> >> > >>> >>> > > > > > > >>>> On Thu, 11 Apr 2019 at 02:11, Aizhamal
> Nurmamat
> >> > kyzy
> >> > >>> >>> > > > > > > >>>> <[hidden email]> wrote:
> >> > >>> >>> > > > > > > >>>>
> >> > >>> >>> > > > > > > >>>>> Hello everyone,
> >> > >>> >>> > > > > > > >>>>>
> >> > >>> >>> > > > > > > >>>>> @Fabian Hueske <[hidden email]> - SoD
> >> setup
> >> > is
> >> > >>> a
> >> > >>> >>> little
> >> > >>> >>> > > bit
> >> > >>> >>> > > > > > > >>> different.
> >> > >>> >>> > > > > > > >>>>> The ASF determined that each project would
> be
> >> > >>> allowed
> >> > >>> >>> to
> >> > >>> >>> > > apply
> >> > >>> >>> > > > > > > >>>>> individually[1], rather than applying as a
> >> single
> >> > >>> large
> >> > >>> >>> > > > > > organization.
> >> > >>> >>> > > > > > > >>>>>
> >> > >>> >>> > > > > > > >>>>> Each project applies as an org, with two
> >> > organizers
> >> > >>> >>> > > > (administers)
> >> > >>> >>> > > > > > and
> >> > >>> >>> > > > > > > >> at
> >> > >>> >>> > > > > > > >>>>> least two mentors. As Konstantin pointed
> out,
> >> one
> >> > >>> can
> >> > >>> >>> be
> >> > >>> >>> > both
> >> > >>> >>> > > > an
> >> > >>> >>> > > > > > > >>>>> administer
> >> > >>> >>> > > > > > > >>>>> and a mentor. You don't need to coordinate
> >> with
> >> > >>> other
> >> > >>> >>> > > projects
> >> > >>> >>> > > > or
> >> > >>> >>> > > > > > ASF
> >> > >>> >>> > > > > > > >> at
> >> > >>> >>> > > > > > > >>>>> all. If accepted to the program, you will
> >> receive
> >> > >>> >>> project
> >> > >>> >>> > > > > proposals
> >> > >>> >>> > > > > > > >> from
> >> > >>> >>> > > > > > > >>>>> tech writers [2]. You will choose one or two
> >> > >>> proposals
> >> > >>> >>> that
> >> > >>> >>> > > you
> >> > >>> >>> > > > > > want
> >> > >>> >>> > > > > > > >> to
> >> > >>> >>> > > > > > > >>>>> mentor[3].
> >> > >>> >>> > > > > > > >>>>>
> >> > >>> >>> > > > > > > >>>>> @Ken - as for the language, there isn’t any
> >> > >>> >>> limitations in
> >> > >>> >>> > > that
> >> > >>> >>> > > > > > > >> regard,
> >> > >>> >>> > > > > > > >>> so
> >> > >>> >>> > > > > > > >>>>> work on the Chinese translation for the
> >> website
> >> > is
> >> > >>> >>> > definitely
> >> > >>> >>> > > > an
> >> > >>> >>> > > > > > > >>>>> acceptable
> >> > >>> >>> > > > > > > >>>>> project.
> >> > >>> >>> > > > > > > >>>>>
> >> > >>> >>> > > > > > > >>>>> Thanks,
> >> > >>> >>> > > > > > > >>>>>
> >> > >>> >>> > > > > > > >>>>> Aizhamal
> >> > >>> >>> > > > > > > >>>>>
> >> > >>> >>> > > > > > > >>>>>
> >> > >>> >>> > > > > > > >>>>> [1]
> >> > >>> >>> > > > > > > >>>>>
> >> > >>> >>> > > > > > > >>>>>
> >> > >>> >>> > > > > > > >>>
> >> > >>> >>> > > > > > > >>
> >> > >>> >>> > > > > > >
> >> > >>> >>> > > > > >
> >> > >>> >>> > > > >
> >> > >>> >>> > > >
> >> > >>> >>> > >
> >> > >>> >>> >
> >> > >>> >>>
> >> > >>>
> >> >
> >>
> https://lists.apache.org/thread.html/67e1c2e6041cff1e7f198b615407401f032795130e796adfaacf8071@%3Cdev.community.apache.org%3E
> >> > >>> >>> > > > > > > >>>>>
> >> > >>> >>> > > > > > > >>>>> [2]
> >> > >>> https://developers.google.com/season-of-docs/docs/
> >> > >>> >>> > > > > > > >>>>>
> >> > >>> >>> > > > > > > >>>>> [3]
> >> > >>> >>> > > > > > > >>>
> >> > >>> >>> > > > > >
> >> > >>> >>> > >
> >> > >>> >>>
> >> > >>>
> >> https://developers.google.com/season-of-docs/docs/faq#slot-allocation
> >> > >>> >>> > > > > > > >>>>>
> >> > >>> >>> > > > > > > >>>>>
> >> > >>> >>> > > > > > > >>>>> On Wed, Apr 10, 2019 at 8:32 AM Ken Krugler
> <
> >> > >>> >>> > > > > > > >>> [hidden email]>
> >> > >>> >>> > > > > > > >>>>> wrote:
> >> > >>> >>> > > > > > > >>>>>
> >> > >>> >>> > > > > > > >>>>>> Hi Aizhamal,
> >> > >>> >>> > > > > > > >>>>>>
> >> > >>> >>> > > > > > > >>>>>> I assume SoD is language-agnostic, so one
> >> > possible
> >> > >>> >>> project
> >> > >>> >>> > > > would
> >> > >>> >>> > > > > > be
> >> > >>> >>> > > > > > > >> to
> >> > >>> >>> > > > > > > >>>>> get
> >> > >>> >>> > > > > > > >>>>>> a tech writer for the Chinese versions of
> >> all of
> >> > >>> the
> >> > >>> >>> Flink
> >> > >>> >>> > > > > > > >>>>> documentation,
> >> > >>> >>> > > > > > > >>>>>> yes?
> >> > >>> >>> > > > > > > >>>>>>
> >> > >>> >>> > > > > > > >>>>>> Regards,
> >> > >>> >>> > > > > > > >>>>>>
> >> > >>> >>> > > > > > > >>>>>> — Ken
> >> > >>> >>> > > > > > > >>>>>>
> >> > >>> >>> > > > > > > >>>>>>> On Apr 5, 2019, at 3:43 PM, Aizhamal
> >> Nurmamat
> >> > >>> kyzy
> >> > >>> >>> > > > > > > >>>>>> <[hidden email]> wrote:
> >> > >>> >>> > > > > > > >>>>>>>
> >> > >>> >>> > > > > > > >>>>>>> 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
> >> > >>> >>> > > > > > >
> >> > >>> >>> > > > > > > --------------------------
> >> > >>> >>> > > > > > > Ken Krugler
> >> > >>> >>> > > > > > > [phone]
> >> > >>> >>> > > > > > > http://www.scaleunlimited.com
> >> > >>> >>> > > > > > > Custom big data solutions & training
> >> > >>> >>> > > > > > > Flink, Solr, Hadoop, Cascading & Cassandra
> >> > >>> >>> > > > > > >
> >> > >>> >>> > > > > > >
> >> > >>> >>> > > > > >
> >> > >>> >>> > > > >
> >> > >>> >>> > > >
> >> > >>> >>> > >
> >> > >>> >>> >
> >> > >>> >>>
> >> > >>> >>
> >> > >>> >>
> >> > >>> >> --
> >> > >>> >>
> >> > >>> >> Konstantin Knauf | Solutions Architect
> >> > >>> >>
> >> > >>> >> [phone]
> >> > >>> >>
> >> > >>> >> <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
> >> > >>> >>
> >> > >>> >
> >> > >>>
> >> > >>> --
> >> > >>>
> >> > >>> Konstantin Knauf | Solutions Architect
> >> > >>>
> >> > >>> [phone]
> >> > >>>
> >> > >>> <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
> >> > >>>
> >> > >>
> >> >
> >> > --
> >> >
> >> > Konstantin Knauf | Solutions Architect
> >> >
> >> > [phone]
> >> >
> >> >
> >> > Planned Absences: 17.04.2019 - 26.04.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
> >> >
> >>
> >
>

--

Konstantin Knauf | Solutions Architect

[phone]


Planned Absences: 17.04.2019 - 26.04.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

[Stephan Ewen-4]

Thank you so much for driving this, really great job!

About Flink internals: Agreed, that is not a good match. It needs to deep
technical understanding. Also, the benefit of having a technical writer
(make this easily understandable to less involved developers) is not as
helpful there.

Also registered as a mentor.

Lets keep our fingers crossed and hope that everything goes well!

Cheers!


On Wed, Apr 17, 2019 at 6:14 PM Konstantin Knauf <[hidden email]>
wrote:

> Hi everyone,
>
> a few updates on our application:
>
> 1. As Aizhamal (Thanks!) has suggested I also added the information to
> submit during our application to the Google doc [1] and Fabian added a
> description for the SQL project idea (Thanks!).
>
> 2. I had a quick chat with Fabian offline and we concluded, that the
> "Flink Internals" project might not be good fit for Season of Docs after
> all, because, we think, the amount of mentoring by core developers that
> would be necessary to produce such a documentation could not be guaranteed.
> Any opinions?
>
> 3. To submit our application, we need to publish our project ideas list.
> For this I have just opened a PR to add a small blog post about Season of
> Docs [2]. Please have a look and provide feedback.
>
> 4. For mentors (Stephan, Fabian, Jark, David) please complete the mentor
> registration [3] by next Tuesday (*Application Deadline*)
>
> Cheers,
>
> Konstantin
>
> [1]
> https://docs.google.com/document/d/1Up53jNsLztApn-mP76AB6xWUVGt3nwS9p6xQTiceKXo/edit?usp=sharing
> [2] https://github.com/apache/flink-web/pull/202
> [3]
> https://docs.google.com/forms/d/e/1FAIpQLSe-JjGvaKKGWZOXxrorONhB8qN3mjPrB9ZVkcsntR73Cv_K7g/viewform
>
> On Mon, Apr 15, 2019 at 9:12 PM Aizhamal Nurmamat kyzy <
> [hidden email]> wrote:
>
>> +Konstantin Knauf <[hidden email]> this is looking good,
>> thanks for sharing!
>>
>> I also created a similar doc for Apache Airflow [1]. It is a bit messy,
>> but it has questions from the application form that you can work with.
>>
>> Cheers,
>> Aizhamal
>>
>> [1]
>> https://docs.google.com/document/d/1HoL_yjNYiTAP9IxSlhx3EUnPFU4l9WOT9EnwBZjCZo0/edit#
>>
>>
>> On Mon, Apr 15, 2019 at 2:24 AM Robert Metzger <[hidden email]>
>> wrote:
>>
>>> Hi all,
>>> I'm very happy to see this project happening!
>>>
>>> Thank you for the proposal Konstantin! One idea for the "related
>>> material": we could also link to talks or blog posts about concepts /
>>> monitoring / operations. Potential writers could feel overwhelmed by our
>>> demand for improvements, without any additional material.
>>>
>>>
>>> On Mon, Apr 15, 2019 at 10:16 AM Konstantin Knauf <
>>> [hidden email]> wrote:
>>>
>>>> Hi everyone,
>>>>
>>>> thanks @Aizhamal Nurmamat kyzy <[hidden email]>. As we only have
>>>> one
>>>> week left until the application deadline, I went ahead and created a
>>>> document for the project ideas [1]. I have added the description for the
>>>> "stream processing concepts" as well as the "deployment & operations
>>>> documentation" project idea. Please let me know what you think, edit &
>>>> comment. We also need descriptions for the other two projects (Table
>>>> API/SQL & Flink Internals). @Fabian/@Jark/@Stephan can you chime in?
>>>>
>>>> Any more project ideas?
>>>>
>>>> Best,
>>>>
>>>> Konstantin
>>>>
>>>>
>>>> [1]
>>>>
>>>> https://docs.google.com/document/d/1Up53jNsLztApn-mP76AB6xWUVGt3nwS9p6xQTiceKXo/edit?usp=sharing
>>>>
>>>>
>>>>
>>>> On Fri, Apr 12, 2019 at 6:50 PM Aizhamal Nurmamat kyzy <
>>>> [hidden email]>
>>>> wrote:
>>>>
>>>> > Hello everyone,
>>>> >
>>>> > @Konstantin Knauf <[hidden email]> - yes, you are correct.
>>>> > Between steps 1 and 2 though, the open source organization, in this
>>>> case
>>>> > Flink, has to be selected by SoD as one of the participating orgs
>>>> *fingers
>>>> > crossed*.
>>>> >
>>>> > One tip about organizing ideas is that you want to communicate
>>>> potential
>>>> > projects to the tech writers that are applying. Just make sure the
>>>> scope of
>>>> > the project is clear to them. The SoD wants to set up the tech
>>>> writers for
>>>> > success by making sure the work can be done in the allotted time.
>>>> >
>>>> > Hope it helps.
>>>> >
>>>> > Aizhamal
>>>> >
>>>> >
>>>> >
>>>> > On Fri, Apr 12, 2019 at 7:37 AM Konstantin Knauf <
>>>> [hidden email]>
>>>> > wrote:
>>>> >
>>>> >> Hi all,
>>>> >>
>>>> >> I read through the SoD documentation again, and now I think, it would
>>>> >> actually make sense to split (1) up into multiple project ideas. Let
>>>> me
>>>> >> summarize the overall process:
>>>> >>
>>>> >> 1. We create & publish a list of project ideas, e.g. in a blog post.
>>>> >> (This can be any number of ideas.)
>>>> >> 2. Potential technical writers look at our list of ideas and sent a
>>>> >> proposal for a particular project to Google. During that time they
>>>> can
>>>> >> reach out to us for clarification.
>>>> >> 3. Google forwards all proposals for our project ideas to us and we
>>>> sent
>>>> >> back a prioritized list of proposals, which we would like to accept.
>>>> >> 4. Of all these proposals, Google accepts 50 proposals for SoD 2019.
>>>> Per
>>>> >> organization Google will only accept a maximum of two proposals.
>>>> >>
>>>> >> @Aizhamal Nurmamat kyzy <[hidden email]> Please correct me!
>>>> >>
>>>> >> For me this means we should splits this up in a way, that each
>>>> project is
>>>> >> a) still relevant in September b) makes sense as a 3 month project.
>>>> Based
>>>> >> on the ideas we have right now these could for example be:
>>>> >>
>>>> >> (I) Rework/Extract/Improve the documentation of stream processing
>>>> concepts
>>>> >> (II) Improve & extend Apache Flink's documentation for deployment,
>>>> >> operations (incl. configuration)
>>>> >> (III) Add documentation for Flink internals
>>>> >> (IV) Rework Table API / SQL documentation
>>>> >>
>>>> >> We would then get proposals potentially for all of these topics and
>>>> could
>>>> >> decide which of these proposals, we would sent back to Google. My
>>>> feeling
>>>> >> is that a technical writer could easily spent three months on any of
>>>> these
>>>> >> projects. What do others think? Any other project ideas?
>>>> >>
>>>> >> Cheers,
>>>> >>
>>>> >> Konstantin
>>>> >>
>>>> >>
>>>> >>
>>>> >>
>>>> >> On Fri, Apr 12, 2019 at 1:47 PM Jark Wu <[hidden email]> wrote:
>>>> >>
>>>> >>> Hi all,
>>>> >>>
>>>> >>> I'm fine with only preparing the first proposal. I think it's
>>>> reasonable
>>>> >>> because the first proposal is more attractive
>>>> >>> and maybe there is not enough Chinese writer. We can focus on one
>>>> project
>>>> >>> to come up with a concrete and
>>>> >>> attractive project plan.
>>>> >>>
>>>> >>> One possible subproject could be rework Table SQL docs.
>>>> >>> (1). Improve concepts in Table SQL.
>>>> >>> (2). A more detailed introduction of built-in functions, currently
>>>> we
>>>> >>> only
>>>> >>> have a simple explanation for each function.
>>>> >>>       We should add more descriptions, especially more concrete
>>>> examples,
>>>> >>> and maybe some notes. We can take
>>>> >>>       MySQL doc [1] as a reference.
>>>> >>> (3). As Flink SQL is evolving rapidly and features from Blink is
>>>> being
>>>> >>> merged,  for example, SQL DDL, Hive integration,
>>>> >>>       Python Table API, Interactive Programing, SQL optimization and
>>>> >>> tuning, etc... We can redesign the doc structure of
>>>> >>>       Table SQL in a higher vision.
>>>> >>>
>>>> >>> Cheers,
>>>> >>> Jark
>>>> >>>
>>>> >>> [1]:
>>>> >>>
>>>> >>>
>>>> https://dev.mysql.com/doc/refman/5.7/en/string-functions.html#function_bin
>>>> >>>
>>>> >>>
>>>> >>>
>>>> >>> On Fri, 12 Apr 2019 at 18:19, jincheng sun <
>>>> [hidden email]>
>>>> >>> wrote:
>>>> >>>
>>>> >>> > I am honored to have the opportunity to do a second organization
>>>> >>> > administrator‘s works!
>>>> >>> >
>>>> >>> > It seems that one project and multiple projects have their own
>>>> >>> advantages.
>>>> >>> >
>>>> >>> > My understanding is that even if we only have one project, we
>>>> also can
>>>> >>> have
>>>> >>> > multiple mentors and recruit enough writers.
>>>> >>> >
>>>> >>> > Fabian Hueske <[hidden email]> 于2019年4月12日周五 下午5:57写道：
>>>> >>> >
>>>> >>> > > Yes, I think we would get at most one project accepted.
>>>> >>> > > Having all options in a rather generic proposal gives us the
>>>> most
>>>> >>> > > flexibility to decide what to work on once the proposal is
>>>> accepted.
>>>> >>> > > On the other hand, a more concrete proposal might look more
>>>> >>> attractive
>>>> >>> > for
>>>> >>> > > candidates.
>>>> >>> > > I'm fine either way, but my gut feeling is that a well scoped
>>>> >>> proposal
>>>> >>> > > gives better changes of finding a writer (which might be the
>>>> biggest
>>>> >>> > > challenge).
>>>> >>> > >
>>>> >>> > > Am Fr., 12. Apr. 2019 um 11:39 Uhr schrieb Stephan Ewen <
>>>> >>> > [hidden email]
>>>> >>> > > >:
>>>> >>> > >
>>>> >>> > > > I would suggest to make one proposal and have the subsections
>>>> only
>>>> >>> in
>>>> >>> > the
>>>> >>> > > > project plan.
>>>> >>> > > > My understanding is that we need to indicate priorities
>>>> between
>>>> >>> > proposals
>>>> >>> > > > and might get only one, so it would be good to not subdivide.
>>>> >>> > > >
>>>> >>> > > > On Fri, Apr 12, 2019 at 9:58 AM Fabian Hueske <
>>>> [hidden email]>
>>>> >>> > wrote:
>>>> >>> > > >
>>>> >>> > > > > Hi everyone,
>>>> >>> > > > >
>>>> >>> > > > > I think we can split the first project that Stephan
>>>> proposed into
>>>> >>> > > smaller
>>>> >>> > > > > ones:
>>>> >>> > > > >
>>>> >>> > > > > > (1) Create or rework setup / tutorials / concepts docs
>>>> >>> > > > > > (2) Complete (or advance) the Chinese translation
>>>> >>> > > > >
>>>> >>> > > > > 1.1 Improving (extracting) the documentation of stream
>>>> processing
>>>> >>> > > > concepts:
>>>> >>> > > > > Event-time, Timers, State, State Backends, Checkpointing,
>>>> >>> Savepoints
>>>> >>> > > > > Right now, the relevant information is scattered across
>>>> several
>>>> >>> pages
>>>> >>> > > and
>>>> >>> > > > > mixed with the implementation / APIs / configuration
>>>> options.
>>>> >>> > > > >
>>>> >>> > > > > 1.2 Improving & extending the documentation of deployments
>>>> >>> > > > >
>>>> >>> > > > > 1.3 Adding documentation in the internals: Distributed
>>>> >>> architecture,
>>>> >>> > > > > recovery, operators, job translation, execution, etc.
>>>> >>> > > > > This documentation would be targeted to Flink developers.
>>>> >>> > > > >
>>>> >>> > > > > I thought again about the idea of improving the tutorials,
>>>> and
>>>> >>> I'm no
>>>> >>> > > > > longer sure if this would fit SoD well.
>>>> >>> > > > > The reason is that creating good tutorials requires a good
>>>> >>> portion of
>>>> >>> > > > > coding / configuration (creating Docker images, example
>>>> programs,
>>>> >>> > > etc.).
>>>> >>> > > > > Also I'd like to start improving the situation of tutorials
>>>> >>> earlier
>>>> >>> > > than
>>>> >>> > > > > September.
>>>> >>> > > > >
>>>> >>> > > > > What do others think?
>>>> >>> > > > >
>>>> >>> > > > > Cheers, Fabian
>>>> >>> > > > >
>>>> >>> > > > >
>>>> >>> > > > > Am Fr., 12. Apr. 2019 um 04:29 Uhr schrieb Jark Wu <
>>>> >>> [hidden email]
>>>> >>> > >:
>>>> >>> > > > >
>>>> >>> > > > > > Hi Konstantin, Ken,
>>>> >>> > > > > >
>>>> >>> > > > > > I agree that Chinese documentation is mainly a
>>>> translation.
>>>> >>> > > > > >
>>>> >>> > > > > > >  Does anyone from the Blink team have input on whether
>>>> there
>>>> >>> is
>>>> >>> > > > > existing,
>>>> >>> > > > > > original Chinese documentation which should be translated
>>>> to
>>>> >>> > English?
>>>> >>> > > > > >
>>>> >>> > > > > > There is a public Blink documentation [1] which is
>>>> English.
>>>> >>> > > > > > We have a Blink Chinese documentation in internal, but I
>>>> think
>>>> >>> we
>>>> >>> > > need
>>>> >>> > > > to
>>>> >>> > > > > > rewrite it in English and restructure it when contributing
>>>> >>> Blink to
>>>> >>> > > > > Flink.
>>>> >>> > > > > >
>>>> >>> > > > > > Regarding the Chinese translation project, I agree with
>>>> Ken's
>>>> >>> > > opinion.
>>>> >>> > > > > >
>>>> >>> > > > > > From the point of my translation experience, translation
>>>> is a
>>>> >>> work
>>>> >>> > > that
>>>> >>> > > > > > need to understand the original English sentence
>>>> correctly and
>>>> >>> then
>>>> >>> > > > > express
>>>> >>> > > > > > it in Chinese in an easily understandable way. This is
>>>> not a
>>>> >>> simple
>>>> >>> > > > work
>>>> >>> > > > > > that translate word by word. The one we need is not a
>>>> >>> "professional
>>>> >>> > > > > > translator",
>>>> >>> > > > > > but a "technical writer who are familiar with both
>>>> >>> languages".  I
>>>> >>> > > also
>>>> >>> > > > > > agree that the writer who write the initial documentation
>>>> has
>>>> >>> the
>>>> >>> > > > better
>>>> >>> > > > > > ability than
>>>> >>> > > > > > translator to distill complex technical concepts.
>>>> >>> > > > > >
>>>> >>> > > > > > [1]: https://flink-china.org/doc/blink
>>>> >>> > > > > >
>>>> >>> > > > > > On Fri, 12 Apr 2019 at 02:40, Ken Krugler <
>>>> >>> > > [hidden email]
>>>> >>> > > > >
>>>> >>> > > > > > wrote:
>>>> >>> > > > > >
>>>> >>> > > > > > > Hi Konstantin,
>>>> >>> > > > > > >
>>>> >>> > > > > > > Comments inline below…
>>>> >>> > > > > > >
>>>> >>> > > > > > > — Ken
>>>> >>> > > > > > >
>>>> >>> > > > > > > > On Apr 11, 2019, at 9:05 AM, Konstantin Knauf <
>>>> >>> > > > > > [hidden email]>
>>>> >>> > > > > > > wrote:
>>>> >>> > > > > > > >
>>>> >>> > > > > > > > Hi everyone,
>>>> >>> > > > > > > >
>>>> >>> > > > > > > > I will start going through the registration process
>>>> >>> tomorrow
>>>> >>> > > (CET).
>>>> >>> > > > > > > > Jincheng (cc) reached out to me directly and offered
>>>> to be
>>>> >>> the
>>>> >>> > > > second
>>>> >>> > > > > > > > organization administrator. So, we are all set in that
>>>> >>> regard.
>>>> >>> > > > > > > >
>>>> >>> > > > > > > > In terms of mentors, we now have
>>>> >>> > > > > > > >
>>>> >>> > > > > > > > * myself
>>>> >>> > > > > > > > * Fabian
>>>> >>> > > > > > > > * David
>>>> >>> > > > > > > > * Stephan
>>>> >>> > > > > > > > * Jark (Chinese Translation)
>>>> >>> > > > > > > >
>>>> >>> > > > > > > > Regarding the Chinese translation project, it is
>>>> probably a
>>>> >>> > > > question
>>>> >>> > > > > of
>>>> >>> > > > > > > how
>>>> >>> > > > > > > > independent the Chinese version is supposed to be. If
>>>> the
>>>> >>> > English
>>>> >>> > > > > > > > documentation is the ground-truth and the Chinese
>>>> >>> documentation
>>>> >>> > > is
>>>> >>> > > > > > > (mainly)
>>>> >>> > > > > > > > a translation, I agree with Stefan. If the Chinese
>>>> >>> > documentation
>>>> >>> > > is
>>>> >>> > > > > > > > supposed to become an independent secondary
>>>> documentation,
>>>> >>> it
>>>> >>> > > could
>>>> >>> > > > > be
>>>> >>> > > > > > a
>>>> >>> > > > > > > > project for a technical writer as well. Has this
>>>> questions
>>>> >>> > > already
>>>> >>> > > > > been
>>>> >>> > > > > > > > discussed in the community?
>>>> >>> > > > > > >
>>>> >>> > > > > > > My understanding is that the Chinese documentation is
>>>> going
>>>> >>> to
>>>> >>> > > mostly
>>>> >>> > > > > be
>>>> >>> > > > > > a
>>>> >>> > > > > > > translation of the English versions.
>>>> >>> > > > > > >
>>>> >>> > > > > > > Though perhaps, with all of the Blink integration going
>>>> on,
>>>> >>> the
>>>> >>> > > > inverse
>>>> >>> > > > > > > could also be true.
>>>> >>> > > > > > >
>>>> >>> > > > > > > Does anyone from the Blink team have input on whether
>>>> there
>>>> >>> is
>>>> >>> > > > > existing,
>>>> >>> > > > > > > original Chinese documentation which should be
>>>> translated to
>>>> >>> > > English?
>>>> >>> > > > > > >
>>>> >>> > > > > > > > On Thu, Apr 11, 2019 at 11:34 AM Stephan Ewen <
>>>> >>> > [hidden email]>
>>>> >>> > > > > > wrote:
>>>> >>> > > > > > > >
>>>> >>> > > > > > > >> So we have two ideas for docs projects now:
>>>> >>> > > > > > > >>
>>>> >>> > > > > > > >> (1) Create or rework setup / tutorials / concepts
>>>> docs
>>>> >>> > > > > > > >> (2) Complete (or advance) the Chinese translation
>>>> >>> > > > > > > >>
>>>> >>> > > > > > > >> Should we apply for both (and let the SoD committee
>>>> select
>>>> >>> > > > whichever
>>>> >>> > > > > > > they
>>>> >>> > > > > > > >> want to sponsor) or select one of them?
>>>> >>> > > > > > > >>
>>>> >>> > > > > > > >> For project (2), this sounds to me more like a
>>>> project
>>>> >>> for a
>>>> >>> > > > > > > "translator",
>>>> >>> > > > > > > >> not a "technical writer". As far as I understand it,
>>>> the
>>>> >>> big
>>>> >>> > > > benefit
>>>> >>> > > > > > of
>>>> >>> > > > > > > >> having a technical writer is to have someone who can
>>>> >>> describe
>>>> >>> > > > > > > complicated
>>>> >>> > > > > > > >> technical concepts (that engineers describe in
>>>> complicated
>>>> >>> > > > language)
>>>> >>> > > > > > in
>>>> >>> > > > > > > an
>>>> >>> > > > > > > >> easily understandable way.
>>>> >>> > > > > > >
>>>> >>> > > > > > > Actually a good Chinese translation of the technical
>>>> docs
>>>> >>> > requires
>>>> >>> > > > > > someone
>>>> >>> > > > > > > with many of the same skills. In order for the
>>>> translation
>>>> >>> to be
>>>> >>> > > > > > accurate,
>>>> >>> > > > > > > you need someone who understands the concepts of the
>>>> >>> underlying
>>>> >>> > > > > > technology,
>>>> >>> > > > > > > to use appropriate terminology. Though I agree that the
>>>> >>> ability
>>>> >>> > to
>>>> >>> > > > > > distill
>>>> >>> > > > > > > complex technical concepts is more important when
>>>> writing
>>>> >>> initial
>>>> >>> > > > > > > documentation.
>>>> >>> > > > > > >
>>>> >>> > > > > > >
>>>> >>> > > > > > > >> On Thu, Apr 11, 2019 at 9:47 AM Fabian Hueske <
>>>> >>> > > [hidden email]>
>>>> >>> > > > > > > wrote:
>>>> >>> > > > > > > >>
>>>> >>> > > > > > > >>> Thanks for the clarification Aizhamal!
>>>> >>> > > > > > > >>> This is really helpful and will make it a lot
>>>> easier to
>>>> >>> > > > coordinate
>>>> >>> > > > > > :-)
>>>> >>> > > > > > > >>>
>>>> >>> > > > > > > >>> As for next steps, I found this email on the
>>>> >>> > > > > > [hidden email]
>>>> >>> > > > > > > >>> mailing list:
>>>> >>> > > > > > > >>>
>>>> >>> > > > > > > >>> ==================================================
>>>> >>> > > > > > > >>> Hi All,
>>>> >>> > > > > > > >>>
>>>> >>> > > > > > > >>> As mentioned the applications for the Google Season
>>>> of
>>>> >>> Docs
>>>> >>> > > > opened
>>>> >>> > > > > > > today
>>>> >>> > > > > > > >>> and I'm working my way through it on behalf of the
>>>> ASF.
>>>> >>> > > > > > > >>>
>>>> >>> > > > > > > >>> If accepted, we will be allocated either one or two
>>>> >>> techical
>>>> >>> > > > > writers.
>>>> >>> > > > > > > >>> Google will also pay the ASF a stipend of $500 per
>>>> >>> technical
>>>> >>> > > > writer
>>>> >>> > > > > > > >>> mentored (which I hope can go directly to
>>>> fundraising :-)
>>>> >>> > > > > > > >>>
>>>> >>> > > > > > > >>> Each project that wants to participate must provide
>>>> two
>>>> >>> > mentors
>>>> >>> > > > for
>>>> >>> > > > > > > each
>>>> >>> > > > > > > >>> documentation project.
>>>> >>> > > > > > > >>>
>>>> >>> > > > > > > >>> As part of the application process there are a few
>>>> things
>>>> >>> > that
>>>> >>> > > we
>>>> >>> > > > > > need
>>>> >>> > > > > > > to
>>>> >>> > > > > > > >>> setup.
>>>> >>> > > > > > > >>>
>>>> >>> > > > > > > >>> 1. Season of Docs Page and List of Project Ideas
>>>> >>> > > > > > > >>> We need to create a public webpage about Season of
>>>> Docs
>>>> >>> that
>>>> >>> > > > > contains
>>>> >>> > > > > > > the
>>>> >>> > > > > > > >>> list of project ideas for documentation. I have
>>>> created a
>>>> >>> > page
>>>> >>> > > on
>>>> >>> > > > > the
>>>> >>> > > > > > > >>> ComDev wiki https://s.apache.org/w4CH  with a
>>>> table for
>>>> >>> > > projects
>>>> >>> > > > > to
>>>> >>> > > > > > > >> record
>>>> >>> > > > > > > >>> their ideas.
>>>> >>> > > > > > > >>>
>>>> >>> > > > > > > >>> 2. Alternative administrator.
>>>> >>> > > > > > > >>> I’ve set myself up as the primary admin and Maxim
>>>> as the
>>>> >>> > > > > alternative
>>>> >>> > > > > > > >> admin
>>>> >>> > > > > > > >>> (Maxim, I need to confirm your contact email and
>>>> you will
>>>> >>> > also
>>>> >>> > > > need
>>>> >>> > > > > > to
>>>> >>> > > > > > > >>> register as the alternative admin and I will email
>>>> you
>>>> >>> the
>>>> >>> > link
>>>> >>> > > > > > > offline)
>>>> >>> > > > > > > >>>
>>>> >>> > > > > > > >>> 3. Mentors
>>>> >>> > > > > > > >>> All mentors from the projects interested in
>>>> participating
>>>> >>> > must
>>>> >>> > > > > > register
>>>> >>> > > > > > > >>> individually at the following link :
>>>> >>> > > > > > > https://forms.gle/a1x26WQGzURLerv66
>>>> >>> > > > > > > >> .
>>>> >>> > > > > > > >>>
>>>> >>> > > > > > > >>> 4. Application Form: Documentation / Technnial
>>>> Writer
>>>> >>> > > > Collaboration
>>>> >>> > > > > > > >>> There is a section to fill in about experience with
>>>> >>> > > documentation
>>>> >>> > > > > and
>>>> >>> > > > > > > any
>>>> >>> > > > > > > >>> previous collaboration with technical writers. I
>>>> know a
>>>> >>> few
>>>> >>> > > > > projects
>>>> >>> > > > > > > have
>>>> >>> > > > > > > >>> used various tools for documentation - but not sure
>>>> >>> about any
>>>> >>> > > > > > technical
>>>> >>> > > > > > > >>> writing collaboration (so if you know of any then
>>>> please
>>>> >>> let
>>>> >>> > me
>>>> >>> > > > > know)
>>>> >>> > > > > > > >>>
>>>> >>> > > > > > > >>> 5. Application Form: GSoC
>>>> >>> > > > > > > >>> There is a section to complete at our participation
>>>> in
>>>> >>> GSoC.I
>>>> >>> > > > > think I
>>>> >>> > > > > > > >> have
>>>> >>> > > > > > > >>> the details from our application this year so can
>>>> follow
>>>> >>> up
>>>> >>> > > with
>>>> >>> > > > > > Maxim
>>>> >>> > > > > > > or
>>>> >>> > > > > > > >>> Uli about it
>>>> >>> > > > > > > >>>
>>>> >>> > > > > > > >>> This is all I have at the moment and we have until
>>>> the
>>>> >>> 23rd
>>>> >>> > > April
>>>> >>> > > > > > 2019
>>>> >>> > > > > > > to
>>>> >>> > > > > > > >>> finalise all the application details. Ideally I
>>>> want to
>>>> >>> have
>>>> >>> > it
>>>> >>> > > > > done
>>>> >>> > > > > > > well
>>>> >>> > > > > > > >>> before then :-)
>>>> >>> > > > > > > >>>
>>>> >>> > > > > > > >>> Please pass on this information within your various
>>>> >>> projects
>>>> >>> > > and
>>>> >>> > > > as
>>>> >>> > > > > > > with
>>>> >>> > > > > > > >>> GSoC - I'll see how we can get this information out
>>>> to
>>>> >>> all
>>>> >>> > our
>>>> >>> > > > > > project
>>>> >>> > > > > > > >>> mailing lists.
>>>> >>> > > > > > > >>>
>>>> >>> > > > > > > >>> Thanks
>>>> >>> > > > > > > >>> Sharan
>>>> >>> > > > > > > >>>
>>>> >>> > > > > > > >>> ==================================================
>>>> >>> > > > > > > >>>
>>>> >>> > > > > > > >>> I guess, we would need to follow these steps as
>>>> well.
>>>> >>> > > > > > > >>>
>>>> >>> > > > > > > >>> Best,
>>>> >>> > > > > > > >>> Fabian
>>>> >>> > > > > > > >>>
>>>> >>> > > > > > > >>> Am Do., 11. Apr. 2019 um 05:08 Uhr schrieb Jark Wu <
>>>> >>> > > > > [hidden email]
>>>> >>> > > > > > >:
>>>> >>> > > > > > > >>>
>>>> >>> > > > > > > >>>> Hi Aizhamal,
>>>> >>> > > > > > > >>>>
>>>> >>> > > > > > > >>>> That's really interesting. We have an ongoing
>>>> proposal
>>>> >>> for
>>>> >>> > > > > > supporting
>>>> >>> > > > > > > >>>> Chinese documentation, see FLIP-35 [1].
>>>> >>> > > > > > > >>>>
>>>> >>> > > > > > > >>>> I think it's a good idea to propose Chinese
>>>> translation
>>>> >>> as a
>>>> >>> > > > > > project.
>>>> >>> > > > > > > >>> It's
>>>> >>> > > > > > > >>>> a good chance to improve the localization user
>>>> >>> experience of
>>>> >>> > > > Flink
>>>> >>> > > > > > > >>>> documentation.
>>>> >>> > > > > > > >>>> I can help as a mentor if we want to submit such a
>>>> >>> project.
>>>> >>> > > > > > > >>>>
>>>> >>> > > > > > > >>>> Thanks,
>>>> >>> > > > > > > >>>> Jark Wu
>>>> >>> > > > > > > >>>>
>>>> >>> > > > > > > >>>> [1]:
>>>> >>> > > > > > > >>>>
>>>> >>> > > > > > > >>>
>>>> >>> > > > > > > >>
>>>> >>> > > > > > >
>>>> >>> > > > > >
>>>> >>> > > > >
>>>> >>> > > >
>>>> >>> > >
>>>> >>> >
>>>> >>>
>>>> https://cwiki.apache.org/confluence/display/FLINK/FLIP-35%3A+Support+Chinese+Documents+and+Website
>>>> >>> > > > > > > >>>>
>>>> >>> > > > > > > >>>> On Thu, 11 Apr 2019 at 02:11, Aizhamal Nurmamat
>>>> kyzy
>>>> >>> > > > > > > >>>> <[hidden email]> wrote:
>>>> >>> > > > > > > >>>>
>>>> >>> > > > > > > >>>>> Hello everyone,
>>>> >>> > > > > > > >>>>>
>>>> >>> > > > > > > >>>>> @Fabian Hueske <[hidden email]> - SoD setup
>>>> is a
>>>> >>> little
>>>> >>> > > bit
>>>> >>> > > > > > > >>> different.
>>>> >>> > > > > > > >>>>> The ASF determined that each project would be
>>>> allowed
>>>> >>> to
>>>> >>> > > apply
>>>> >>> > > > > > > >>>>> individually[1], rather than applying as a single
>>>> large
>>>> >>> > > > > > organization.
>>>> >>> > > > > > > >>>>>
>>>> >>> > > > > > > >>>>> Each project applies as an org, with two
>>>> organizers
>>>> >>> > > > (administers)
>>>> >>> > > > > > and
>>>> >>> > > > > > > >> at
>>>> >>> > > > > > > >>>>> least two mentors. As Konstantin pointed out, one
>>>> can
>>>> >>> be
>>>> >>> > both
>>>> >>> > > > an
>>>> >>> > > > > > > >>>>> administer
>>>> >>> > > > > > > >>>>> and a mentor. You don't need to coordinate with
>>>> other
>>>> >>> > > projects
>>>> >>> > > > or
>>>> >>> > > > > > ASF
>>>> >>> > > > > > > >> at
>>>> >>> > > > > > > >>>>> all. If accepted to the program, you will receive
>>>> >>> project
>>>> >>> > > > > proposals
>>>> >>> > > > > > > >> from
>>>> >>> > > > > > > >>>>> tech writers [2]. You will choose one or two
>>>> proposals
>>>> >>> that
>>>> >>> > > you
>>>> >>> > > > > > want
>>>> >>> > > > > > > >> to
>>>> >>> > > > > > > >>>>> mentor[3].
>>>> >>> > > > > > > >>>>>
>>>> >>> > > > > > > >>>>> @Ken - as for the language, there isn’t any
>>>> >>> limitations in
>>>> >>> > > that
>>>> >>> > > > > > > >> regard,
>>>> >>> > > > > > > >>> so
>>>> >>> > > > > > > >>>>> work on the Chinese translation for the website is
>>>> >>> > definitely
>>>> >>> > > > an
>>>> >>> > > > > > > >>>>> acceptable
>>>> >>> > > > > > > >>>>> project.
>>>> >>> > > > > > > >>>>>
>>>> >>> > > > > > > >>>>> Thanks,
>>>> >>> > > > > > > >>>>>
>>>> >>> > > > > > > >>>>> Aizhamal
>>>> >>> > > > > > > >>>>>
>>>> >>> > > > > > > >>>>>
>>>> >>> > > > > > > >>>>> [1]
>>>> >>> > > > > > > >>>>>
>>>> >>> > > > > > > >>>>>
>>>> >>> > > > > > > >>>
>>>> >>> > > > > > > >>
>>>> >>> > > > > > >
>>>> >>> > > > > >
>>>> >>> > > > >
>>>> >>> > > >
>>>> >>> > >
>>>> >>> >
>>>> >>>
>>>> https://lists.apache.org/thread.html/67e1c2e6041cff1e7f198b615407401f032795130e796adfaacf8071@%3Cdev.community.apache.org%3E
>>>> >>> > > > > > > >>>>>
>>>> >>> > > > > > > >>>>> [2]
>>>> https://developers.google.com/season-of-docs/docs/
>>>> >>> > > > > > > >>>>>
>>>> >>> > > > > > > >>>>> [3]
>>>> >>> > > > > > > >>>
>>>> >>> > > > > >
>>>> >>> > >
>>>> >>>
>>>> https://developers.google.com/season-of-docs/docs/faq#slot-allocation
>>>> >>> > > > > > > >>>>>
>>>> >>> > > > > > > >>>>>
>>>> >>> > > > > > > >>>>> On Wed, Apr 10, 2019 at 8:32 AM Ken Krugler <
>>>> >>> > > > > > > >>> [hidden email]>
>>>> >>> > > > > > > >>>>> wrote:
>>>> >>> > > > > > > >>>>>
>>>> >>> > > > > > > >>>>>> Hi Aizhamal,
>>>> >>> > > > > > > >>>>>>
>>>> >>> > > > > > > >>>>>> I assume SoD is language-agnostic, so one
>>>> possible
>>>> >>> project
>>>> >>> > > > would
>>>> >>> > > > > > be
>>>> >>> > > > > > > >> to
>>>> >>> > > > > > > >>>>> get
>>>> >>> > > > > > > >>>>>> a tech writer for the Chinese versions of all of
>>>> the
>>>> >>> Flink
>>>> >>> > > > > > > >>>>> documentation,
>>>> >>> > > > > > > >>>>>> yes?
>>>> >>> > > > > > > >>>>>>
>>>> >>> > > > > > > >>>>>> Regards,
>>>> >>> > > > > > > >>>>>>
>>>> >>> > > > > > > >>>>>> — Ken
>>>> >>> > > > > > > >>>>>>
>>>> >>> > > > > > > >>>>>>> On Apr 5, 2019, at 3:43 PM, Aizhamal Nurmamat
>>>> kyzy
>>>> >>> > > > > > > >>>>>> <[hidden email]> wrote:
>>>> >>> > > > > > > >>>>>>>
>>>> >>> > > > > > > >>>>>>> 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
>>>> >>> > > > > > >
>>>> >>> > > > > > > --------------------------
>>>> >>> > > > > > > Ken Krugler
>>>> >>> > > > > > > [phone]
>>>> >>> > > > > > > http://www.scaleunlimited.com
>>>> >>> > > > > > > Custom big data solutions & training
>>>> >>> > > > > > > Flink, Solr, Hadoop, Cascading & Cassandra
>>>> >>> > > > > > >
>>>> >>> > > > > > >
>>>> >>> > > > > >
>>>> >>> > > > >
>>>> >>> > > >
>>>> >>> > >
>>>> >>> >
>>>> >>>
>>>> >>
>>>> >>
>>>> >> --
>>>> >>
>>>> >> Konstantin Knauf | Solutions Architect
>>>> >>
>>>> >> [phone]
>>>> >>
>>>> >> <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
>>>> >>
>>>> >
>>>>
>>>> --
>>>>
>>>> Konstantin Knauf | Solutions Architect
>>>>
>>>> [phone]
>>>>
>>>> <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
>>>>
>>>
>
> --
>
> Konstantin Knauf | Solutions Architect
>
> [phone]
>
>
> Planned Absences: 17.04.2019 - 26.04.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
>

[jincheng sun]

Hi all,
As you may already know, unfortunately, our application for GSoD was
unsuccessful.

But the thinking we have made for this is also very helpful to the Flink
community, such as the optimization of the document structure proposed
by @Fabian
Hueske <[hidden email]>  the addition of better tutorials, Add Chinese
document that @Jark Wu  <[hidden email]>continues to advance.  It is also
a huge gain for us to participate in this GSOD. At the same time, I also
asked the GSOD team why we didn't apply successfully. We will continue to
sum up experience and strive for the next success! no matter what, Thanks
to everyone who helped here!

Regards,
Jincheng



Stephan Ewen <[hidden email]> 于2019年4月24日周三 下午2:08写道：

> Thank you so much for driving this, really great job!
>
> About Flink internals: Agreed, that is not a good match. It needs to deep
> technical understanding. Also, the benefit of having a technical writer
> (make this easily understandable to less involved developers) is not as
> helpful there.
>
> Also registered as a mentor.
>
> Lets keep our fingers crossed and hope that everything goes well!
>
> Cheers!
>
>
> On Wed, Apr 17, 2019 at 6:14 PM Konstantin Knauf <[hidden email]
> >
> wrote:
>
> > Hi everyone,
> >
> > a few updates on our application:
> >
> > 1. As Aizhamal (Thanks!) has suggested I also added the information to
> > submit during our application to the Google doc [1] and Fabian added a
> > description for the SQL project idea (Thanks!).
> >
> > 2. I had a quick chat with Fabian offline and we concluded, that the
> > "Flink Internals" project might not be good fit for Season of Docs after
> > all, because, we think, the amount of mentoring by core developers that
> > would be necessary to produce such a documentation could not be
> guaranteed.
> > Any opinions?
> >
> > 3. To submit our application, we need to publish our project ideas list.
> > For this I have just opened a PR to add a small blog post about Season of
> > Docs [2]. Please have a look and provide feedback.
> >
> > 4. For mentors (Stephan, Fabian, Jark, David) please complete the mentor
> > registration [3] by next Tuesday (*Application Deadline*)
> >
> > Cheers,
> >
> > Konstantin
> >
> > [1]
> >
> https://docs.google.com/document/d/1Up53jNsLztApn-mP76AB6xWUVGt3nwS9p6xQTiceKXo/edit?usp=sharing
> > [2] https://github.com/apache/flink-web/pull/202
> > [3]
> >
> https://docs.google.com/forms/d/e/1FAIpQLSe-JjGvaKKGWZOXxrorONhB8qN3mjPrB9ZVkcsntR73Cv_K7g/viewform
> >
> > On Mon, Apr 15, 2019 at 9:12 PM Aizhamal Nurmamat kyzy <
> > [hidden email]> wrote:
> >
> >> +Konstantin Knauf <[hidden email]> this is looking good,
> >> thanks for sharing!
> >>
> >> I also created a similar doc for Apache Airflow [1]. It is a bit messy,
> >> but it has questions from the application form that you can work with.
> >>
> >> Cheers,
> >> Aizhamal
> >>
> >> [1]
> >>
> https://docs.google.com/document/d/1HoL_yjNYiTAP9IxSlhx3EUnPFU4l9WOT9EnwBZjCZo0/edit#
> >>
> >>
> >> On Mon, Apr 15, 2019 at 2:24 AM Robert Metzger <[hidden email]>
> >> wrote:
> >>
> >>> Hi all,
> >>> I'm very happy to see this project happening!
> >>>
> >>> Thank you for the proposal Konstantin! One idea for the "related
> >>> material": we could also link to talks or blog posts about concepts /
> >>> monitoring / operations. Potential writers could feel overwhelmed by
> our
> >>> demand for improvements, without any additional material.
> >>>
> >>>
> >>> On Mon, Apr 15, 2019 at 10:16 AM Konstantin Knauf <
> >>> [hidden email]> wrote:
> >>>
> >>>> Hi everyone,
> >>>>
> >>>> thanks @Aizhamal Nurmamat kyzy <[hidden email]>. As we only have
> >>>> one
> >>>> week left until the application deadline, I went ahead and created a
> >>>> document for the project ideas [1]. I have added the description for
> the
> >>>> "stream processing concepts" as well as the "deployment & operations
> >>>> documentation" project idea. Please let me know what you think, edit &
> >>>> comment. We also need descriptions for the other two projects (Table
> >>>> API/SQL & Flink Internals). @Fabian/@Jark/@Stephan can you chime in?
> >>>>
> >>>> Any more project ideas?
> >>>>
> >>>> Best,
> >>>>
> >>>> Konstantin
> >>>>
> >>>>
> >>>> [1]
> >>>>
> >>>>
> https://docs.google.com/document/d/1Up53jNsLztApn-mP76AB6xWUVGt3nwS9p6xQTiceKXo/edit?usp=sharing
> >>>>
> >>>>
> >>>>
> >>>> On Fri, Apr 12, 2019 at 6:50 PM Aizhamal Nurmamat kyzy <
> >>>> [hidden email]>
> >>>> wrote:
> >>>>
> >>>> > Hello everyone,
> >>>> >
> >>>> > @Konstantin Knauf <[hidden email]> - yes, you are
> correct.
> >>>> > Between steps 1 and 2 though, the open source organization, in this
> >>>> case
> >>>> > Flink, has to be selected by SoD as one of the participating orgs
> >>>> *fingers
> >>>> > crossed*.
> >>>> >
> >>>> > One tip about organizing ideas is that you want to communicate
> >>>> potential
> >>>> > projects to the tech writers that are applying. Just make sure the
> >>>> scope of
> >>>> > the project is clear to them. The SoD wants to set up the tech
> >>>> writers for
> >>>> > success by making sure the work can be done in the allotted time.
> >>>> >
> >>>> > Hope it helps.
> >>>> >
> >>>> > Aizhamal
> >>>> >
> >>>> >
> >>>> >
> >>>> > On Fri, Apr 12, 2019 at 7:37 AM Konstantin Knauf <
> >>>> [hidden email]>
> >>>> > wrote:
> >>>> >
> >>>> >> Hi all,
> >>>> >>
> >>>> >> I read through the SoD documentation again, and now I think, it
> would
> >>>> >> actually make sense to split (1) up into multiple project ideas.
> Let
> >>>> me
> >>>> >> summarize the overall process:
> >>>> >>
> >>>> >> 1. We create & publish a list of project ideas, e.g. in a blog
> post.
> >>>> >> (This can be any number of ideas.)
> >>>> >> 2. Potential technical writers look at our list of ideas and sent a
> >>>> >> proposal for a particular project to Google. During that time they
> >>>> can
> >>>> >> reach out to us for clarification.
> >>>> >> 3. Google forwards all proposals for our project ideas to us and we
> >>>> sent
> >>>> >> back a prioritized list of proposals, which we would like to
> accept.
> >>>> >> 4. Of all these proposals, Google accepts 50 proposals for SoD
> 2019.
> >>>> Per
> >>>> >> organization Google will only accept a maximum of two proposals.
> >>>> >>
> >>>> >> @Aizhamal Nurmamat kyzy <[hidden email]> Please correct me!
> >>>> >>
> >>>> >> For me this means we should splits this up in a way, that each
> >>>> project is
> >>>> >> a) still relevant in September b) makes sense as a 3 month project.
> >>>> Based
> >>>> >> on the ideas we have right now these could for example be:
> >>>> >>
> >>>> >> (I) Rework/Extract/Improve the documentation of stream processing
> >>>> concepts
> >>>> >> (II) Improve & extend Apache Flink's documentation for deployment,
> >>>> >> operations (incl. configuration)
> >>>> >> (III) Add documentation for Flink internals
> >>>> >> (IV) Rework Table API / SQL documentation
> >>>> >>
> >>>> >> We would then get proposals potentially for all of these topics and
> >>>> could
> >>>> >> decide which of these proposals, we would sent back to Google. My
> >>>> feeling
> >>>> >> is that a technical writer could easily spent three months on any
> of
> >>>> these
> >>>> >> projects. What do others think? Any other project ideas?
> >>>> >>
> >>>> >> Cheers,
> >>>> >>
> >>>> >> Konstantin
> >>>> >>
> >>>> >>
> >>>> >>
> >>>> >>
> >>>> >> On Fri, Apr 12, 2019 at 1:47 PM Jark Wu <[hidden email]> wrote:
> >>>> >>
> >>>> >>> Hi all,
> >>>> >>>
> >>>> >>> I'm fine with only preparing the first proposal. I think it's
> >>>> reasonable
> >>>> >>> because the first proposal is more attractive
> >>>> >>> and maybe there is not enough Chinese writer. We can focus on one
> >>>> project
> >>>> >>> to come up with a concrete and
> >>>> >>> attractive project plan.
> >>>> >>>
> >>>> >>> One possible subproject could be rework Table SQL docs.
> >>>> >>> (1). Improve concepts in Table SQL.
> >>>> >>> (2). A more detailed introduction of built-in functions, currently
> >>>> we
> >>>> >>> only
> >>>> >>> have a simple explanation for each function.
> >>>> >>>       We should add more descriptions, especially more concrete
> >>>> examples,
> >>>> >>> and maybe some notes. We can take
> >>>> >>>       MySQL doc [1] as a reference.
> >>>> >>> (3). As Flink SQL is evolving rapidly and features from Blink is
> >>>> being
> >>>> >>> merged,  for example, SQL DDL, Hive integration,
> >>>> >>>       Python Table API, Interactive Programing, SQL optimization
> and
> >>>> >>> tuning, etc... We can redesign the doc structure of
> >>>> >>>       Table SQL in a higher vision.
> >>>> >>>
> >>>> >>> Cheers,
> >>>> >>> Jark
> >>>> >>>
> >>>> >>> [1]:
> >>>> >>>
> >>>> >>>
> >>>>
> https://dev.mysql.com/doc/refman/5.7/en/string-functions.html#function_bin
> >>>> >>>
> >>>> >>>
> >>>> >>>
> >>>> >>> On Fri, 12 Apr 2019 at 18:19, jincheng sun <
> >>>> [hidden email]>
> >>>> >>> wrote:
> >>>> >>>
> >>>> >>> > I am honored to have the opportunity to do a second organization
> >>>> >>> > administrator‘s works!
> >>>> >>> >
> >>>> >>> > It seems that one project and multiple projects have their own
> >>>> >>> advantages.
> >>>> >>> >
> >>>> >>> > My understanding is that even if we only have one project, we
> >>>> also can
> >>>> >>> have
> >>>> >>> > multiple mentors and recruit enough writers.
> >>>> >>> >
> >>>> >>> > Fabian Hueske <[hidden email]> 于2019年4月12日周五 下午5:57写道：
> >>>> >>> >
> >>>> >>> > > Yes, I think we would get at most one project accepted.
> >>>> >>> > > Having all options in a rather generic proposal gives us the
> >>>> most
> >>>> >>> > > flexibility to decide what to work on once the proposal is
> >>>> accepted.
> >>>> >>> > > On the other hand, a more concrete proposal might look more
> >>>> >>> attractive
> >>>> >>> > for
> >>>> >>> > > candidates.
> >>>> >>> > > I'm fine either way, but my gut feeling is that a well scoped
> >>>> >>> proposal
> >>>> >>> > > gives better changes of finding a writer (which might be the
> >>>> biggest
> >>>> >>> > > challenge).
> >>>> >>> > >
> >>>> >>> > > Am Fr., 12. Apr. 2019 um 11:39 Uhr schrieb Stephan Ewen <
> >>>> >>> > [hidden email]
> >>>> >>> > > >:
> >>>> >>> > >
> >>>> >>> > > > I would suggest to make one proposal and have the
> subsections
> >>>> only
> >>>> >>> in
> >>>> >>> > the
> >>>> >>> > > > project plan.
> >>>> >>> > > > My understanding is that we need to indicate priorities
> >>>> between
> >>>> >>> > proposals
> >>>> >>> > > > and might get only one, so it would be good to not
> subdivide.
> >>>> >>> > > >
> >>>> >>> > > > On Fri, Apr 12, 2019 at 9:58 AM Fabian Hueske <
> >>>> [hidden email]>
> >>>> >>> > wrote:
> >>>> >>> > > >
> >>>> >>> > > > > Hi everyone,
> >>>> >>> > > > >
> >>>> >>> > > > > I think we can split the first project that Stephan
> >>>> proposed into
> >>>> >>> > > smaller
> >>>> >>> > > > > ones:
> >>>> >>> > > > >
> >>>> >>> > > > > > (1) Create or rework setup / tutorials / concepts docs
> >>>> >>> > > > > > (2) Complete (or advance) the Chinese translation
> >>>> >>> > > > >
> >>>> >>> > > > > 1.1 Improving (extracting) the documentation of stream
> >>>> processing
> >>>> >>> > > > concepts:
> >>>> >>> > > > > Event-time, Timers, State, State Backends, Checkpointing,
> >>>> >>> Savepoints
> >>>> >>> > > > > Right now, the relevant information is scattered across
> >>>> several
> >>>> >>> pages
> >>>> >>> > > and
> >>>> >>> > > > > mixed with the implementation / APIs / configuration
> >>>> options.
> >>>> >>> > > > >
> >>>> >>> > > > > 1.2 Improving & extending the documentation of deployments
> >>>> >>> > > > >
> >>>> >>> > > > > 1.3 Adding documentation in the internals: Distributed
> >>>> >>> architecture,
> >>>> >>> > > > > recovery, operators, job translation, execution, etc.
> >>>> >>> > > > > This documentation would be targeted to Flink developers.
> >>>> >>> > > > >
> >>>> >>> > > > > I thought again about the idea of improving the tutorials,
> >>>> and
> >>>> >>> I'm no
> >>>> >>> > > > > longer sure if this would fit SoD well.
> >>>> >>> > > > > The reason is that creating good tutorials requires a good
> >>>> >>> portion of
> >>>> >>> > > > > coding / configuration (creating Docker images, example
> >>>> programs,
> >>>> >>> > > etc.).
> >>>> >>> > > > > Also I'd like to start improving the situation of
> tutorials
> >>>> >>> earlier
> >>>> >>> > > than
> >>>> >>> > > > > September.
> >>>> >>> > > > >
> >>>> >>> > > > > What do others think?
> >>>> >>> > > > >
> >>>> >>> > > > > Cheers, Fabian
> >>>> >>> > > > >
> >>>> >>> > > > >
> >>>> >>> > > > > Am Fr., 12. Apr. 2019 um 04:29 Uhr schrieb Jark Wu <
> >>>> >>> [hidden email]
> >>>> >>> > >:
> >>>> >>> > > > >
> >>>> >>> > > > > > Hi Konstantin, Ken,
> >>>> >>> > > > > >
> >>>> >>> > > > > > I agree that Chinese documentation is mainly a
> >>>> translation.
> >>>> >>> > > > > >
> >>>> >>> > > > > > >  Does anyone from the Blink team have input on whether
> >>>> there
> >>>> >>> is
> >>>> >>> > > > > existing,
> >>>> >>> > > > > > original Chinese documentation which should be
> translated
> >>>> to
> >>>> >>> > English?
> >>>> >>> > > > > >
> >>>> >>> > > > > > There is a public Blink documentation [1] which is
> >>>> English.
> >>>> >>> > > > > > We have a Blink Chinese documentation in internal, but I
> >>>> think
> >>>> >>> we
> >>>> >>> > > need
> >>>> >>> > > > to
> >>>> >>> > > > > > rewrite it in English and restructure it when
> contributing
> >>>> >>> Blink to
> >>>> >>> > > > > Flink.
> >>>> >>> > > > > >
> >>>> >>> > > > > > Regarding the Chinese translation project, I agree with
> >>>> Ken's
> >>>> >>> > > opinion.
> >>>> >>> > > > > >
> >>>> >>> > > > > > From the point of my translation experience, translation
> >>>> is a
> >>>> >>> work
> >>>> >>> > > that
> >>>> >>> > > > > > need to understand the original English sentence
> >>>> correctly and
> >>>> >>> then
> >>>> >>> > > > > express
> >>>> >>> > > > > > it in Chinese in an easily understandable way. This is
> >>>> not a
> >>>> >>> simple
> >>>> >>> > > > work
> >>>> >>> > > > > > that translate word by word. The one we need is not a
> >>>> >>> "professional
> >>>> >>> > > > > > translator",
> >>>> >>> > > > > > but a "technical writer who are familiar with both
> >>>> >>> languages".  I
> >>>> >>> > > also
> >>>> >>> > > > > > agree that the writer who write the initial
> documentation
> >>>> has
> >>>> >>> the
> >>>> >>> > > > better
> >>>> >>> > > > > > ability than
> >>>> >>> > > > > > translator to distill complex technical concepts.
> >>>> >>> > > > > >
> >>>> >>> > > > > > [1]: https://flink-china.org/doc/blink
> >>>> >>> > > > > >
> >>>> >>> > > > > > On Fri, 12 Apr 2019 at 02:40, Ken Krugler <
> >>>> >>> > > [hidden email]
> >>>> >>> > > > >
> >>>> >>> > > > > > wrote:
> >>>> >>> > > > > >
> >>>> >>> > > > > > > Hi Konstantin,
> >>>> >>> > > > > > >
> >>>> >>> > > > > > > Comments inline below…
> >>>> >>> > > > > > >
> >>>> >>> > > > > > > — Ken
> >>>> >>> > > > > > >
> >>>> >>> > > > > > > > On Apr 11, 2019, at 9:05 AM, Konstantin Knauf <
> >>>> >>> > > > > > [hidden email]>
> >>>> >>> > > > > > > wrote:
> >>>> >>> > > > > > > >
> >>>> >>> > > > > > > > Hi everyone,
> >>>> >>> > > > > > > >
> >>>> >>> > > > > > > > I will start going through the registration process
> >>>> >>> tomorrow
> >>>> >>> > > (CET).
> >>>> >>> > > > > > > > Jincheng (cc) reached out to me directly and offered
> >>>> to be
> >>>> >>> the
> >>>> >>> > > > second
> >>>> >>> > > > > > > > organization administrator. So, we are all set in
> that
> >>>> >>> regard.
> >>>> >>> > > > > > > >
> >>>> >>> > > > > > > > In terms of mentors, we now have
> >>>> >>> > > > > > > >
> >>>> >>> > > > > > > > * myself
> >>>> >>> > > > > > > > * Fabian
> >>>> >>> > > > > > > > * David
> >>>> >>> > > > > > > > * Stephan
> >>>> >>> > > > > > > > * Jark (Chinese Translation)
> >>>> >>> > > > > > > >
> >>>> >>> > > > > > > > Regarding the Chinese translation project, it is
> >>>> probably a
> >>>> >>> > > > question
> >>>> >>> > > > > of
> >>>> >>> > > > > > > how
> >>>> >>> > > > > > > > independent the Chinese version is supposed to be.
> If
> >>>> the
> >>>> >>> > English
> >>>> >>> > > > > > > > documentation is the ground-truth and the Chinese
> >>>> >>> documentation
> >>>> >>> > > is
> >>>> >>> > > > > > > (mainly)
> >>>> >>> > > > > > > > a translation, I agree with Stefan. If the Chinese
> >>>> >>> > documentation
> >>>> >>> > > is
> >>>> >>> > > > > > > > supposed to become an independent secondary
> >>>> documentation,
> >>>> >>> it
> >>>> >>> > > could
> >>>> >>> > > > > be
> >>>> >>> > > > > > a
> >>>> >>> > > > > > > > project for a technical writer as well. Has this
> >>>> questions
> >>>> >>> > > already
> >>>> >>> > > > > been
> >>>> >>> > > > > > > > discussed in the community?
> >>>> >>> > > > > > >
> >>>> >>> > > > > > > My understanding is that the Chinese documentation is
> >>>> going
> >>>> >>> to
> >>>> >>> > > mostly
> >>>> >>> > > > > be
> >>>> >>> > > > > > a
> >>>> >>> > > > > > > translation of the English versions.
> >>>> >>> > > > > > >
> >>>> >>> > > > > > > Though perhaps, with all of the Blink integration
> going
> >>>> on,
> >>>> >>> the
> >>>> >>> > > > inverse
> >>>> >>> > > > > > > could also be true.
> >>>> >>> > > > > > >
> >>>> >>> > > > > > > Does anyone from the Blink team have input on whether
> >>>> there
> >>>> >>> is
> >>>> >>> > > > > existing,
> >>>> >>> > > > > > > original Chinese documentation which should be
> >>>> translated to
> >>>> >>> > > English?
> >>>> >>> > > > > > >
> >>>> >>> > > > > > > > On Thu, Apr 11, 2019 at 11:34 AM Stephan Ewen <
> >>>> >>> > [hidden email]>
> >>>> >>> > > > > > wrote:
> >>>> >>> > > > > > > >
> >>>> >>> > > > > > > >> So we have two ideas for docs projects now:
> >>>> >>> > > > > > > >>
> >>>> >>> > > > > > > >> (1) Create or rework setup / tutorials / concepts
> >>>> docs
> >>>> >>> > > > > > > >> (2) Complete (or advance) the Chinese translation
> >>>> >>> > > > > > > >>
> >>>> >>> > > > > > > >> Should we apply for both (and let the SoD committee
> >>>> select
> >>>> >>> > > > whichever
> >>>> >>> > > > > > > they
> >>>> >>> > > > > > > >> want to sponsor) or select one of them?
> >>>> >>> > > > > > > >>
> >>>> >>> > > > > > > >> For project (2), this sounds to me more like a
> >>>> project
> >>>> >>> for a
> >>>> >>> > > > > > > "translator",
> >>>> >>> > > > > > > >> not a "technical writer". As far as I understand
> it,
> >>>> the
> >>>> >>> big
> >>>> >>> > > > benefit
> >>>> >>> > > > > > of
> >>>> >>> > > > > > > >> having a technical writer is to have someone who
> can
> >>>> >>> describe
> >>>> >>> > > > > > > complicated
> >>>> >>> > > > > > > >> technical concepts (that engineers describe in
> >>>> complicated
> >>>> >>> > > > language)
> >>>> >>> > > > > > in
> >>>> >>> > > > > > > an
> >>>> >>> > > > > > > >> easily understandable way.
> >>>> >>> > > > > > >
> >>>> >>> > > > > > > Actually a good Chinese translation of the technical
> >>>> docs
> >>>> >>> > requires
> >>>> >>> > > > > > someone
> >>>> >>> > > > > > > with many of the same skills. In order for the
> >>>> translation
> >>>> >>> to be
> >>>> >>> > > > > > accurate,
> >>>> >>> > > > > > > you need someone who understands the concepts of the
> >>>> >>> underlying
> >>>> >>> > > > > > technology,
> >>>> >>> > > > > > > to use appropriate terminology. Though I agree that
> the
> >>>> >>> ability
> >>>> >>> > to
> >>>> >>> > > > > > distill
> >>>> >>> > > > > > > complex technical concepts is more important when
> >>>> writing
> >>>> >>> initial
> >>>> >>> > > > > > > documentation.
> >>>> >>> > > > > > >
> >>>> >>> > > > > > >
> >>>> >>> > > > > > > >> On Thu, Apr 11, 2019 at 9:47 AM Fabian Hueske <
> >>>> >>> > > [hidden email]>
> >>>> >>> > > > > > > wrote:
> >>>> >>> > > > > > > >>
> >>>> >>> > > > > > > >>> Thanks for the clarification Aizhamal!
> >>>> >>> > > > > > > >>> This is really helpful and will make it a lot
> >>>> easier to
> >>>> >>> > > > coordinate
> >>>> >>> > > > > > :-)
> >>>> >>> > > > > > > >>>
> >>>> >>> > > > > > > >>> As for next steps, I found this email on the
> >>>> >>> > > > > > [hidden email]
> >>>> >>> > > > > > > >>> mailing list:
> >>>> >>> > > > > > > >>>
> >>>> >>> > > > > > > >>> ==================================================
> >>>> >>> > > > > > > >>> Hi All,
> >>>> >>> > > > > > > >>>
> >>>> >>> > > > > > > >>> As mentioned the applications for the Google
> Season
> >>>> of
> >>>> >>> Docs
> >>>> >>> > > > opened
> >>>> >>> > > > > > > today
> >>>> >>> > > > > > > >>> and I'm working my way through it on behalf of the
> >>>> ASF.
> >>>> >>> > > > > > > >>>
> >>>> >>> > > > > > > >>> If accepted, we will be allocated either one or
> two
> >>>> >>> techical
> >>>> >>> > > > > writers.
> >>>> >>> > > > > > > >>> Google will also pay the ASF a stipend of $500 per
> >>>> >>> technical
> >>>> >>> > > > writer
> >>>> >>> > > > > > > >>> mentored (which I hope can go directly to
> >>>> fundraising :-)
> >>>> >>> > > > > > > >>>
> >>>> >>> > > > > > > >>> Each project that wants to participate must
> provide
> >>>> two
> >>>> >>> > mentors
> >>>> >>> > > > for
> >>>> >>> > > > > > > each
> >>>> >>> > > > > > > >>> documentation project.
> >>>> >>> > > > > > > >>>
> >>>> >>> > > > > > > >>> As part of the application process there are a few
> >>>> things
> >>>> >>> > that
> >>>> >>> > > we
> >>>> >>> > > > > > need
> >>>> >>> > > > > > > to
> >>>> >>> > > > > > > >>> setup.
> >>>> >>> > > > > > > >>>
> >>>> >>> > > > > > > >>> 1. Season of Docs Page and List of Project Ideas
> >>>> >>> > > > > > > >>> We need to create a public webpage about Season of
> >>>> Docs
> >>>> >>> that
> >>>> >>> > > > > contains
> >>>> >>> > > > > > > the
> >>>> >>> > > > > > > >>> list of project ideas for documentation. I have
> >>>> created a
> >>>> >>> > page
> >>>> >>> > > on
> >>>> >>> > > > > the
> >>>> >>> > > > > > > >>> ComDev wiki https://s.apache.org/w4CH  with a
> >>>> table for
> >>>> >>> > > projects
> >>>> >>> > > > > to
> >>>> >>> > > > > > > >> record
> >>>> >>> > > > > > > >>> their ideas.
> >>>> >>> > > > > > > >>>
> >>>> >>> > > > > > > >>> 2. Alternative administrator.
> >>>> >>> > > > > > > >>> I’ve set myself up as the primary admin and Maxim
> >>>> as the
> >>>> >>> > > > > alternative
> >>>> >>> > > > > > > >> admin
> >>>> >>> > > > > > > >>> (Maxim, I need to confirm your contact email and
> >>>> you will
> >>>> >>> > also
> >>>> >>> > > > need
> >>>> >>> > > > > > to
> >>>> >>> > > > > > > >>> register as the alternative admin and I will email
> >>>> you
> >>>> >>> the
> >>>> >>> > link
> >>>> >>> > > > > > > offline)
> >>>> >>> > > > > > > >>>
> >>>> >>> > > > > > > >>> 3. Mentors
> >>>> >>> > > > > > > >>> All mentors from the projects interested in
> >>>> participating
> >>>> >>> > must
> >>>> >>> > > > > > register
> >>>> >>> > > > > > > >>> individually at the following link :
> >>>> >>> > > > > > > https://forms.gle/a1x26WQGzURLerv66
> >>>> >>> > > > > > > >> .
> >>>> >>> > > > > > > >>>
> >>>> >>> > > > > > > >>> 4. Application Form: Documentation / Technnial
> >>>> Writer
> >>>> >>> > > > Collaboration
> >>>> >>> > > > > > > >>> There is a section to fill in about experience
> with
> >>>> >>> > > documentation
> >>>> >>> > > > > and
> >>>> >>> > > > > > > any
> >>>> >>> > > > > > > >>> previous collaboration with technical writers. I
> >>>> know a
> >>>> >>> few
> >>>> >>> > > > > projects
> >>>> >>> > > > > > > have
> >>>> >>> > > > > > > >>> used various tools for documentation - but not
> sure
> >>>> >>> about any
> >>>> >>> > > > > > technical
> >>>> >>> > > > > > > >>> writing collaboration (so if you know of any then
> >>>> please
> >>>> >>> let
> >>>> >>> > me
> >>>> >>> > > > > know)
> >>>> >>> > > > > > > >>>
> >>>> >>> > > > > > > >>> 5. Application Form: GSoC
> >>>> >>> > > > > > > >>> There is a section to complete at our
> participation
> >>>> in
> >>>> >>> GSoC.I
> >>>> >>> > > > > think I
> >>>> >>> > > > > > > >> have
> >>>> >>> > > > > > > >>> the details from our application this year so can
> >>>> follow
> >>>> >>> up
> >>>> >>> > > with
> >>>> >>> > > > > > Maxim
> >>>> >>> > > > > > > or
> >>>> >>> > > > > > > >>> Uli about it
> >>>> >>> > > > > > > >>>
> >>>> >>> > > > > > > >>> This is all I have at the moment and we have until
> >>>> the
> >>>> >>> 23rd
> >>>> >>> > > April
> >>>> >>> > > > > > 2019
> >>>> >>> > > > > > > to
> >>>> >>> > > > > > > >>> finalise all the application details. Ideally I
> >>>> want to
> >>>> >>> have
> >>>> >>> > it
> >>>> >>> > > > > done
> >>>> >>> > > > > > > well
> >>>> >>> > > > > > > >>> before then :-)
> >>>> >>> > > > > > > >>>
> >>>> >>> > > > > > > >>> Please pass on this information within your
> various
> >>>> >>> projects
> >>>> >>> > > and
> >>>> >>> > > > as
> >>>> >>> > > > > > > with
> >>>> >>> > > > > > > >>> GSoC - I'll see how we can get this information
> out
> >>>> to
> >>>> >>> all
> >>>> >>> > our
> >>>> >>> > > > > > project
> >>>> >>> > > > > > > >>> mailing lists.
> >>>> >>> > > > > > > >>>
> >>>> >>> > > > > > > >>> Thanks
> >>>> >>> > > > > > > >>> Sharan
> >>>> >>> > > > > > > >>>
> >>>> >>> > > > > > > >>> ==================================================
> >>>> >>> > > > > > > >>>
> >>>> >>> > > > > > > >>> I guess, we would need to follow these steps as
> >>>> well.
> >>>> >>> > > > > > > >>>
> >>>> >>> > > > > > > >>> Best,
> >>>> >>> > > > > > > >>> Fabian
> >>>> >>> > > > > > > >>>
> >>>> >>> > > > > > > >>> Am Do., 11. Apr. 2019 um 05:08 Uhr schrieb Jark
> Wu <
> >>>> >>> > > > > [hidden email]
> >>>> >>> > > > > > >:
> >>>> >>> > > > > > > >>>
> >>>> >>> > > > > > > >>>> Hi Aizhamal,
> >>>> >>> > > > > > > >>>>
> >>>> >>> > > > > > > >>>> That's really interesting. We have an ongoing
> >>>> proposal
> >>>> >>> for
> >>>> >>> > > > > > supporting
> >>>> >>> > > > > > > >>>> Chinese documentation, see FLIP-35 [1].
> >>>> >>> > > > > > > >>>>
> >>>> >>> > > > > > > >>>> I think it's a good idea to propose Chinese
> >>>> translation
> >>>> >>> as a
> >>>> >>> > > > > > project.
> >>>> >>> > > > > > > >>> It's
> >>>> >>> > > > > > > >>>> a good chance to improve the localization user
> >>>> >>> experience of
> >>>> >>> > > > Flink
> >>>> >>> > > > > > > >>>> documentation.
> >>>> >>> > > > > > > >>>> I can help as a mentor if we want to submit such
> a
> >>>> >>> project.
> >>>> >>> > > > > > > >>>>
> >>>> >>> > > > > > > >>>> Thanks,
> >>>> >>> > > > > > > >>>> Jark Wu
> >>>> >>> > > > > > > >>>>
> >>>> >>> > > > > > > >>>> [1]:
> >>>> >>> > > > > > > >>>>
> >>>> >>> > > > > > > >>>
> >>>> >>> > > > > > > >>
> >>>> >>> > > > > > >
> >>>> >>> > > > > >
> >>>> >>> > > > >
> >>>> >>> > > >
> >>>> >>> > >
> >>>> >>> >
> >>>> >>>
> >>>>
> https://cwiki.apache.org/confluence/display/FLINK/FLIP-35%3A+Support+Chinese+Documents+and+Website
> >>>> >>> > > > > > > >>>>
> >>>> >>> > > > > > > >>>> On Thu, 11 Apr 2019 at 02:11, Aizhamal Nurmamat
> >>>> kyzy
> >>>> >>> > > > > > > >>>> <[hidden email]> wrote:
> >>>> >>> > > > > > > >>>>
> >>>> >>> > > > > > > >>>>> Hello everyone,
> >>>> >>> > > > > > > >>>>>
> >>>> >>> > > > > > > >>>>> @Fabian Hueske <[hidden email]> - SoD setup
> >>>> is a
> >>>> >>> little
> >>>> >>> > > bit
> >>>> >>> > > > > > > >>> different.
> >>>> >>> > > > > > > >>>>> The ASF determined that each project would be
> >>>> allowed
> >>>> >>> to
> >>>> >>> > > apply
> >>>> >>> > > > > > > >>>>> individually[1], rather than applying as a
> single
> >>>> large
> >>>> >>> > > > > > organization.
> >>>> >>> > > > > > > >>>>>
> >>>> >>> > > > > > > >>>>> Each project applies as an org, with two
> >>>> organizers
> >>>> >>> > > > (administers)
> >>>> >>> > > > > > and
> >>>> >>> > > > > > > >> at
> >>>> >>> > > > > > > >>>>> least two mentors. As Konstantin pointed out,
> one
> >>>> can
> >>>> >>> be
> >>>> >>> > both
> >>>> >>> > > > an
> >>>> >>> > > > > > > >>>>> administer
> >>>> >>> > > > > > > >>>>> and a mentor. You don't need to coordinate with
> >>>> other
> >>>> >>> > > projects
> >>>> >>> > > > or
> >>>> >>> > > > > > ASF
> >>>> >>> > > > > > > >> at
> >>>> >>> > > > > > > >>>>> all. If accepted to the program, you will
> receive
> >>>> >>> project
> >>>> >>> > > > > proposals
> >>>> >>> > > > > > > >> from
> >>>> >>> > > > > > > >>>>> tech writers [2]. You will choose one or two
> >>>> proposals
> >>>> >>> that
> >>>> >>> > > you
> >>>> >>> > > > > > want
> >>>> >>> > > > > > > >> to
> >>>> >>> > > > > > > >>>>> mentor[3].
> >>>> >>> > > > > > > >>>>>
> >>>> >>> > > > > > > >>>>> @Ken - as for the language, there isn’t any
> >>>> >>> limitations in
> >>>> >>> > > that
> >>>> >>> > > > > > > >> regard,
> >>>> >>> > > > > > > >>> so
> >>>> >>> > > > > > > >>>>> work on the Chinese translation for the website
> is
> >>>> >>> > definitely
> >>>> >>> > > > an
> >>>> >>> > > > > > > >>>>> acceptable
> >>>> >>> > > > > > > >>>>> project.
> >>>> >>> > > > > > > >>>>>
> >>>> >>> > > > > > > >>>>> Thanks,
> >>>> >>> > > > > > > >>>>>
> >>>> >>> > > > > > > >>>>> Aizhamal
> >>>> >>> > > > > > > >>>>>
> >>>> >>> > > > > > > >>>>>
> >>>> >>> > > > > > > >>>>> [1]
> >>>> >>> > > > > > > >>>>>
> >>>> >>> > > > > > > >>>>>
> >>>> >>> > > > > > > >>>
> >>>> >>> > > > > > > >>
> >>>> >>> > > > > > >
> >>>> >>> > > > > >
> >>>> >>> > > > >
> >>>> >>> > > >
> >>>> >>> > >
> >>>> >>> >
> >>>> >>>
> >>>>
> https://lists.apache.org/thread.html/67e1c2e6041cff1e7f198b615407401f032795130e796adfaacf8071@%3Cdev.community.apache.org%3E
> >>>> >>> > > > > > > >>>>>
> >>>> >>> > > > > > > >>>>> [2]
> >>>> https://developers.google.com/season-of-docs/docs/
> >>>> >>> > > > > > > >>>>>
> >>>> >>> > > > > > > >>>>> [3]
> >>>> >>> > > > > > > >>>
> >>>> >>> > > > > >
> >>>> >>> > >
> >>>> >>>
> >>>> https://developers.google.com/season-of-docs/docs/faq#slot-allocation
> >>>> >>> > > > > > > >>>>>
> >>>> >>> > > > > > > >>>>>
> >>>> >>> > > > > > > >>>>> On Wed, Apr 10, 2019 at 8:32 AM Ken Krugler <
> >>>> >>> > > > > > > >>> [hidden email]>
> >>>> >>> > > > > > > >>>>> wrote:
> >>>> >>> > > > > > > >>>>>
> >>>> >>> > > > > > > >>>>>> Hi Aizhamal,
> >>>> >>> > > > > > > >>>>>>
> >>>> >>> > > > > > > >>>>>> I assume SoD is language-agnostic, so one
> >>>> possible
> >>>> >>> project
> >>>> >>> > > > would
> >>>> >>> > > > > > be
> >>>> >>> > > > > > > >> to
> >>>> >>> > > > > > > >>>>> get
> >>>> >>> > > > > > > >>>>>> a tech writer for the Chinese versions of all
> of
> >>>> the
> >>>> >>> Flink
> >>>> >>> > > > > > > >>>>> documentation,
> >>>> >>> > > > > > > >>>>>> yes?
> >>>> >>> > > > > > > >>>>>>
> >>>> >>> > > > > > > >>>>>> Regards,
> >>>> >>> > > > > > > >>>>>>
> >>>> >>> > > > > > > >>>>>> — Ken
> >>>> >>> > > > > > > >>>>>>
> >>>> >>> > > > > > > >>>>>>> On Apr 5, 2019, at 3:43 PM, Aizhamal Nurmamat
> >>>> kyzy
> >>>> >>> > > > > > > >>>>>> <[hidden email]> wrote:
> >>>> >>> > > > > > > >>>>>>>
> >>>> >>> > > > > > > >>>>>>> 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
> >>>> >>> > > > > > >
> >>>> >>> > > > > > > --------------------------
> >>>> >>> > > > > > > Ken Krugler
> >>>> >>> > > > > > > [phone]
> >>>> >>> > > > > > > http://www.scaleunlimited.com
> >>>> >>> > > > > > > Custom big data solutions & training
> >>>> >>> > > > > > > Flink, Solr, Hadoop, Cascading & Cassandra
> >>>> >>> > > > > > >
> >>>> >>> > > > > > >
> >>>> >>> > > > > >
> >>>> >>> > > > >
> >>>> >>> > > >
> >>>> >>> > >
> >>>> >>> >
> >>>> >>>
> >>>> >>
> >>>> >>
> >>>> >> --
> >>>> >>
> >>>> >> Konstantin Knauf | Solutions Architect
> >>>> >>
> >>>> >> [phone]
> >>>> >>
> >>>> >> <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
> >>>> >>
> >>>> >
> >>>>
> >>>> --
> >>>>
> >>>> Konstantin Knauf | Solutions Architect
> >>>>
> >>>> [phone]
> >>>>
> >>>> <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
> >>>>
> >>>
> >
> > --
> >
> > Konstantin Knauf | Solutions Architect
> >
> > [phone]
> >
> >
> > Planned Absences: 17.04.2019 - 26.04.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
> >
>