You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@beam.apache.org by Aman Singal <am...@gmail.com> on 2020/06/06 13:02:21 UTC

Google Season of Docs Contribution

Respected Sir,

I am Aman Singal, I am a 2nd Year undergraduate student. I really would
like to contribute in your esteemed organization in writing documentation.
I have read and understood the requirement of the project "Update of the
runner comparison page / capability matrix". I request you to please share
the details and guide me the path to get started.

Yours Sincerely
Aman Singal

Re: Google Season of Docs Contribution

Posted by Kyle Weaver <kc...@google.com>.
Hello Aman,

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 Mon, Jun 8, 2020 at 9:55 AM Aman Singal <am...@gmail.com> wrote:

> Respected Sir,
>
> I am Aman Singal, I am a 2nd Year undergraduate student. I really would
> like to contribute in your esteemed organization in writing documentation.
> I have read and understood the requirement of the project "Update of the
> runner comparison page / capability matrix". I request you to please
> share the details and guide me the path to get started.
>
> Yours Sincerely
> Aman Singal
>
>