Season of Docs: Interested in working with Apache Beam

[Cynthia Iradukunda <c....@alustudent.com>]

Greetings,

I am hoping this finds you well. I am keenly interested in contributing to
Apache Beam during the Season of Docs.

I am interested in growing my technical writing skills and see the Season
of Docs as an excellent way to achieve that goal. As an entry-level
technical writer, I would appreciate getting some recommendations on how I
can show my ability to work effectively on this project.

I am looking forward to hearing from you.

Best Regards,
Cynthia, Iradukunda

Re: Season of Docs: Interested in working with Apache Beam

[Kyle Weaver <kc...@google.com>]

Hi Cynthia,

Thank you for the introduction and your interest to work on Apache Beam
documentation with Season of Docs. To participate in the program you need
to follow the guides here [1] [2]. If you are new to the program, we
suggest:
Start by studying our proposed project ideas and expected deliverables for
each of them [3].
Explore more in depth the existing related Beam documentation for each
project idea. We provided links to the background material, known issues
and current documentation for both project ideas [4] [5]. Choose one
project you like the most.
Start drafting a proposal with the gaps you have found and ideas for
improvement, and how you would present the new/updated/full documentation.
Here are more tips on how to make your proposal stronger [6]. Please,
follow the guides and make sure you cover all points.
Submit the project proposal to the Google program administrators during the
technical writer application phase. It opens on June 9, 2020. If you want
any feedback for your initial draft, consider using Google Docs and share
on dev@beam.apache.org, so the community members can leave their comments
and suggestions (please check the access to the doc before sending to the
mailing list).
If you have any ideas that you want to brainstorm about, don’t hesitate to
start a discussion in the community list or reach out on Slack channel to
discuss issues related to GSoD documentation [7]. Once you create an
account join #beam-gsod channel.

Project administrators will assess proposals based on these guidelines [8].

Hope it helps. Let us know if you have more questions.

Thanks,
Beam GSoD team


[1] https://developers.google.com/season-of-docs/docs/tech-writer-guide
[2] https://developers.google.com/season-of-docs/terms/tech-writer-terms
[3] https://cwiki.apache.org/confluence/display/BEAM/Google+Season+of+Docs
[4]
https://cwiki.apache.org/confluence/display/BEAM/Google+Season+of+Docs#GoogleSeasonofDocs-1.DeploymentofaFlinkandSparkClusterswithPortableBeam
[5]
https://cwiki.apache.org/confluence/display/BEAM/Google+Season+of+Docs#GoogleSeasonofDocs-2.Updateoftherunnercomparisonpage/capabilitymatrix
[6]
https://developers.google.com/season-of-docs/docs/tech-writer-application-hints
[7]
https://join.slack.com/t/seasonofdocs/shared_invite/enQtNTc0NDgyOTQ5Nzc4LTliZjVlZjRmNmU5ZmFiNmViNmNiMTM5NTdlNTJiYzIzZTk3MDlhMjM3NzE2MzIxNzIxNmZiMmMzNzRmZTI4NmU
[8]
https://developers.google.com/season-of-docs/docs/project-selection#assess-proposal


On Wed, Jun 10, 2020 at 10:53 AM Cynthia Iradukunda <
c.iradukund@alustudent.com> wrote:

> Greetings,
>
> I am hoping this finds you well. I am keenly interested in contributing to
> Apache Beam during the Season of Docs.
>
> I am interested in growing my technical writing skills and see the Season
> of Docs as an excellent way to achieve that goal. As an entry-level
> technical writer, I would appreciate getting some recommendations on how I
> can show my ability to work effectively on this project.
>
> I am looking forward to hearing from you.
>
> Best Regards,
> Cynthia, Iradukunda
>