Interested In Google Season of Docs!

[Roopal Jain]

Hello Flink Dev Community!

I am interested in participating in Google Season of Docs for Apache Flink.
I went through the FLIP-60 detailed proposal and thought this is something
I could do well. I am currently working as a software engineer and have a
B.E in Computer Engineering from one of India's reputed engineering
colleges. I have prior open-source contribution with mentoring for Google
Summer of Code and Google Code-In.
I have prior work experience on Apache Spark and a good grasp on SQL, Java,
and Python.
Please guide me more on how to get started?

Thanks & Regards,
Roopal Jain

[Marta Paes Moreira]

Hi, Roopal.

Thanks for reaching out, we're glad to see that you're interested in giving
the Flink docs a try!

To participate in Google Season of Docs (GSoD), you'll have to submit an
application once the application period opens (June 9th). Because FLIP-60
is very broad, the first step would be to think about what parts of it
you'd like to focus on — or, what you'd like to have as a project proposal
[1].

You can find more information about the whole process of participating in
GSoD in [2].

Let me know if I can help you with anything else or if you need support
with choosing your focus areas.

Marta

[1]
https://developers.google.com/season-of-docs/docs/tech-writer-application-hints#project_proposal
[2]
https://developers.google.com/season-of-docs/docs/tech-writer-application-hints

On Sat, May 16, 2020 at 8:32 AM Roopal Jain <[hidden email]> wrote:

> Hello Flink Dev Community!
>
> I am interested in participating in Google Season of Docs for Apache Flink.
> I went through the FLIP-60 detailed proposal and thought this is something
> I could do well. I am currently working as a software engineer and have a
> B.E in Computer Engineering from one of India's reputed engineering
> colleges. I have prior open-source contribution with mentoring for Google
> Summer of Code and Google Code-In.
> I have prior work experience on Apache Spark and a good grasp on SQL, Java,
> and Python.
> Please guide me more on how to get started?
>
> Thanks & Regards,
> Roopal Jain
>

[Roopal Jain]

Hi Marta,

Thank you for responding to my email. I went through the link you attached.
I have a few questions:
1. As per the https://flink.apache.org/news/2020/05/04/season-of-docs.html,
two ideas are mentioned, one is restructuring the Table API & SQL
documentation and other is extending the same. I want to know how are these
two different? Can one person do both?
2. You mentioned that FLIP-60 is very broad, should I start picking one
section from it, for example, Table API and start contributing content from
https://ci.apache.org/projects/flink/flink-docs-release-1.10/dev/table/ in
the specified order in FLIP-60? Can you please guide me more on how should
I proceed ahead (choosing a specific area)?


Thanks & Regards,
Roopal Jain


On Sat, 16 May 2020 at 17:39, Marta Paes Moreira <[hidden email]>
wrote:

> Hi, Roopal.
>
> Thanks for reaching out, we're glad to see that you're interested in
> giving the Flink docs a try!
>
> To participate in Google Season of Docs (GSoD), you'll have to submit an
> application once the application period opens (June 9th). Because FLIP-60
> is very broad, the first step would be to think about what parts of it
> you'd like to focus on — or, what you'd like to have as a project proposal
> [1].
>
> You can find more information about the whole process of participating in
> GSoD in [2].
>
> Let me know if I can help you with anything else or if you need support
> with choosing your focus areas.
>
> Marta
>
> [1]
> https://developers.google.com/season-of-docs/docs/tech-writer-application-hints#project_proposal
> [2]
> https://developers.google.com/season-of-docs/docs/tech-writer-application-hints
>
> On Sat, May 16, 2020 at 8:32 AM Roopal Jain <[hidden email]> wrote:
>
>> Hello Flink Dev Community!
>>
>> I am interested in participating in Google Season of Docs for Apache
>> Flink.
>> I went through the FLIP-60 detailed proposal and thought this is something
>> I could do well. I am currently working as a software engineer and have a
>> B.E in Computer Engineering from one of India's reputed engineering
>> colleges. I have prior open-source contribution with mentoring for Google
>> Summer of Code and Google Code-In.
>> I have prior work experience on Apache Spark and a good grasp on SQL,
>> Java,
>> and Python.
>> Please guide me more on how to get started?
>>
>> Thanks & Regards,
>> Roopal Jain
>>
>

[Seth Wiesman-4]

Hi Roopal,

*Restructure the Table API & SQL Documentation*

Right now the Table / SQL documentation is very technical and dry to read.
It is more like a technical specification than documentation that a new
user could read. This project is to take the existing content and
rewrite/reorganize it to make what the community already has more
approachable.

*Extend the Table API & SQL Documentation*

This is to add brand new content. This could be tutorials and walkthroughs
to help onboard new users or expanding an under-documented section such as
Hive interop.

These projects admittedly sound very similar and I will make a note to
better explain them in future applications if the community applies next
year.

Please let me know if you have any more questions,

Seth

On Mon, May 18, 2020 at 2:08 AM Roopal Jain <[hidden email]> wrote:

> Hi Marta,
>
> Thank you for responding to my email. I went through the link you attached.
> I have a few questions:
> 1. As per the https://flink.apache.org/news/2020/05/04/season-of-docs.html
> ,
> two ideas are mentioned, one is restructuring the Table API & SQL
> documentation and other is extending the same. I want to know how are these
> two different? Can one person do both?
> 2. You mentioned that FLIP-60 is very broad, should I start picking one
> section from it, for example, Table API and start contributing content from
> https://ci.apache.org/projects/flink/flink-docs-release-1.10/dev/table/ in
> the specified order in FLIP-60? Can you please guide me more on how should
> I proceed ahead (choosing a specific area)?
>
>
> Thanks & Regards,
> Roopal Jain
>
>
> On Sat, 16 May 2020 at 17:39, Marta Paes Moreira <[hidden email]>
> wrote:
>
> > Hi, Roopal.
> >
> > Thanks for reaching out, we're glad to see that you're interested in
> > giving the Flink docs a try!
> >
> > To participate in Google Season of Docs (GSoD), you'll have to submit an
> > application once the application period opens (June 9th). Because FLIP-60
> > is very broad, the first step would be to think about what parts of it
> > you'd like to focus on — or, what you'd like to have as a project
> proposal
> > [1].
> >
> > You can find more information about the whole process of participating in
> > GSoD in [2].
> >
> > Let me know if I can help you with anything else or if you need support
> > with choosing your focus areas.
> >
> > Marta
> >
> > [1]
> >
> https://developers.google.com/season-of-docs/docs/tech-writer-application-hints#project_proposal
> > [2]
> >
> https://developers.google.com/season-of-docs/docs/tech-writer-application-hints
> >
> > On Sat, May 16, 2020 at 8:32 AM Roopal Jain <[hidden email]> wrote:
> >
> >> Hello Flink Dev Community!
> >>
> >> I am interested in participating in Google Season of Docs for Apache
> >> Flink.
> >> I went through the FLIP-60 detailed proposal and thought this is
> something
> >> I could do well. I am currently working as a software engineer and have
> a
> >> B.E in Computer Engineering from one of India's reputed engineering
> >> colleges. I have prior open-source contribution with mentoring for
> Google
> >> Summer of Code and Google Code-In.
> >> I have prior work experience on Apache Spark and a good grasp on SQL,
> >> Java,
> >> and Python.
> >> Please guide me more on how to get started?
> >>
> >> Thanks & Regards,
> >> Roopal Jain
> >>
> >
>

[Roopal Jain]

Hi Marta,


Just wanted to check if you had time to see my email

On Sun, 17 May 2020, 18:01 Roopal Jain, <[hidden email]> wrote:

> Hi Marta,
>
> Thank you for responding to my email. I went through the link you
> attached. I have a few questions:
> 1. As per the https://flink.apache.org/news/2020/05/04/season-of-docs.html,
> two ideas are mentioned, one is restructuring the Table API & SQL
> documentation and other is extending the same. I want to know how are these
> two different? Can one person do both?
> 2. You mentioned that FLIP-60 is very broad, should I start picking one
> section from it, for example, Table API and start contributing content from
> https://ci.apache.org/projects/flink/flink-docs-release-1.10/dev/table/ in
> the specified order in FLIP-60? Can you please guide me more on how should
> I proceed ahead (choosing a specific area)?
>
>
> Thanks & Regards,
> Roopal Jain
>
>
> On Sat, 16 May 2020 at 17:39, Marta Paes Moreira <[hidden email]>
> wrote:
>
>> Hi, Roopal.
>>
>> Thanks for reaching out, we're glad to see that you're interested in
>> giving the Flink docs a try!
>>
>> To participate in Google Season of Docs (GSoD), you'll have to submit an
>> application once the application period opens (June 9th). Because FLIP-60
>> is very broad, the first step would be to think about what parts of it
>> you'd like to focus on — or, what you'd like to have as a project proposal
>> [1].
>>
>> You can find more information about the whole process of participating in
>> GSoD in [2].
>>
>> Let me know if I can help you with anything else or if you need support
>> with choosing your focus areas.
>>
>> Marta
>>
>> [1]
>> https://developers.google.com/season-of-docs/docs/tech-writer-application-hints#project_proposal
>> [2]
>> https://developers.google.com/season-of-docs/docs/tech-writer-application-hints
>>
>> On Sat, May 16, 2020 at 8:32 AM Roopal Jain <[hidden email]> wrote:
>>
>>> Hello Flink Dev Community!
>>>
>>> I am interested in participating in Google Season of Docs for Apache
>>> Flink.
>>> I went through the FLIP-60 detailed proposal and thought this is
>>> something
>>> I could do well. I am currently working as a software engineer and have a
>>> B.E in Computer Engineering from one of India's reputed engineering
>>> colleges. I have prior open-source contribution with mentoring for Google
>>> Summer of Code and Google Code-In.
>>> I have prior work experience on Apache Spark and a good grasp on SQL,
>>> Java,
>>> and Python.
>>> Please guide me more on how to get started?
>>>
>>> Thanks & Regards,
>>> Roopal Jain
>>>
>>

[Jark Wu-2]

Hi Roopal,

I think you may not subscribe the dev mailing list, that's why you can't
see Seth's reply.
You can subscribe dev mailing list by sending email to
[hidden email]

I copied Seth's reply here, hope it can help you:

=============================================================================

Hi Roopal,

*Restructure the Table API & SQL Documentation*

Right now the Table / SQL documentation is very technical and dry to read.
It is more like a technical specification than documentation that a new
user could read. This project is to take the existing content and
rewrite/reorganize it to make what the community already has more
approachable.

*Extend the Table API & SQL Documentation*

This is to add brand new content. This could be tutorials and walkthroughs
to help onboard new users or expanding an under-documented section such as
Hive interop.

These projects admittedly sound very similar and I will make a note to
better explain them in future applications if the community applies next
year.

Please let me know if you have any more questions,

Seth



On Wed, 20 May 2020 at 17:13, Roopal Jain <[hidden email]> wrote:

> Hi Marta,
>
>
> Just wanted to check if you had time to see my email
>
> On Sun, 17 May 2020, 18:01 Roopal Jain, <[hidden email]> wrote:
>
> > Hi Marta,
> >
> > Thank you for responding to my email. I went through the link you
> > attached. I have a few questions:
> > 1. As per the
> https://flink.apache.org/news/2020/05/04/season-of-docs.html,
> > two ideas are mentioned, one is restructuring the Table API & SQL
> > documentation and other is extending the same. I want to know how are
> these
> > two different? Can one person do both?
> > 2. You mentioned that FLIP-60 is very broad, should I start picking one
> > section from it, for example, Table API and start contributing content
> from
> > https://ci.apache.org/projects/flink/flink-docs-release-1.10/dev/table/
> in
> > the specified order in FLIP-60? Can you please guide me more on how
> should
> > I proceed ahead (choosing a specific area)?
> >
> >
> > Thanks & Regards,
> > Roopal Jain
> >
> >
> > On Sat, 16 May 2020 at 17:39, Marta Paes Moreira <[hidden email]>
> > wrote:
> >
> >> Hi, Roopal.
> >>
> >> Thanks for reaching out, we're glad to see that you're interested in
> >> giving the Flink docs a try!
> >>
> >> To participate in Google Season of Docs (GSoD), you'll have to submit an
> >> application once the application period opens (June 9th). Because
> FLIP-60
> >> is very broad, the first step would be to think about what parts of it
> >> you'd like to focus on — or, what you'd like to have as a project
> proposal
> >> [1].
> >>
> >> You can find more information about the whole process of participating
> in
> >> GSoD in [2].
> >>
> >> Let me know if I can help you with anything else or if you need support
> >> with choosing your focus areas.
> >>
> >> Marta
> >>
> >> [1]
> >>
> https://developers.google.com/season-of-docs/docs/tech-writer-application-hints#project_proposal
> >> [2]
> >>
> https://developers.google.com/season-of-docs/docs/tech-writer-application-hints
> >>
> >> On Sat, May 16, 2020 at 8:32 AM Roopal Jain <[hidden email]> wrote:
> >>
> >>> Hello Flink Dev Community!
> >>>
> >>> I am interested in participating in Google Season of Docs for Apache
> >>> Flink.
> >>> I went through the FLIP-60 detailed proposal and thought this is
> >>> something
> >>> I could do well. I am currently working as a software engineer and
> have a
> >>> B.E in Computer Engineering from one of India's reputed engineering
> >>> colleges. I have prior open-source contribution with mentoring for
> Google
> >>> Summer of Code and Google Code-In.
> >>> I have prior work experience on Apache Spark and a good grasp on SQL,
> >>> Java,
> >>> and Python.
> >>> Please guide me more on how to get started?
> >>>
> >>> Thanks & Regards,
> >>> Roopal Jain
> >>>
> >>
>