airflow-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Chen Tong <cix...@gmail.com>
Subject Re: Airflow for Google Season of Docs 2019
Date Tue, 19 Mar 2019 18:37:48 GMT
Hi,

I recently work on improving the Airflow documentations. I am not a tech
writer, but would like to contribute to the existing documentations. Thus,
if possible, I am willing to join the program, learn and practice more.

See a list of jira issues related to documentation.
https://issues.apache.org/jira/browse/AIRFLOW-2881?jql=project%20%3D%20AIRFLOW%20AND%20resolution%20%3D%20Unresolved%20AND%20component%20in%20(docs%2C%20Documentation)%20ORDER%20BY%20priority%20DESC%2C%20updated%20DESC

Thanks,
Chen

On Tue, Mar 19, 2019 at 1:10 PM Aizhamal Nurmamat kyzy
<aizhamal@google.com.invalid> wrote:

> Hello everybody!
>
> The application process for mentor organizations (projects) starts on April
> 2nd. I believe ASF applies as an org and Airflow must submit its *project
> ideas list* with that application, like in GSoC. I'll confirm with the ASF
> / Comdev whether that'll be the case.
>
> I can give my full support to administer the process of putting down the
> list together, maybe also help on-boarding the tech writer to ASF to reduce
> the extra load on others. We would, however, need support from at least two
> Airflow committers
> <https://developers.google.com/season-of-docs/docs/admin-guide> to review
> Pull Requests, and support the writer to become familiar with the project
> and the tools.
>
> As the application period approaches, we need to be ready to submit project
> ideas list with one or more documentation projects.
>
> Thanks,
>
> On Mon, Mar 18, 2019 at 11:58 PM Gerard Toonstra <gtoonstra@gmail.com>
> wrote:
>
> > This sounds interesting. I set up the site "ETL with airflow" ages ago
> and
> > it's still getting daily forks / stars on github.
> >
> > I'm not a tech writer, but have good experience writing documentation and
> > would like to learn about the scope and objectives
> > and what the docs have to cover that's not already in the current
> > documentation.
> >
> > Rgds,
> >
> > Gerard
> >
> >
> > On Tue, Mar 19, 2019 at 5:56 AM Gerardo Curiel <gerardo@gerar.do> wrote:
> >
> > > Hi Aizhamal,
> > >
> > > Yes, it would be amazing if we could get some help around
> documentation.
> > > There's a few Jira tickets related to this as well.
> > >
> > > Who would like to be a mentor?
> > >
> > > On 13 March 2019 at 8:29:41 am, Aizhamal Nurmamat kyzy (
> > > aizhamal@google.com.invalid) wrote:
> > >
> > > Hello everyone,
> > >
> > > TL;DR Google Season of Docs (GSoC for Documentation) was announced
> > > yesterday. Airflow can benefit from this program, as it doesn't have a
> > > designated technical writer. To participate, an Airflow member can
> > directly
> > > apply before 23rd April, and if selected, the team will have a chance
> to
> > > receive an experienced technical writer for 3 months helping to improve
> > the
> > > documentation.
> > >
> > >
> > > Google Season of Docs is the program that brings open source projects
> and
> > > technical writers together [1]. It is similar to Google Summer of Code
> > but
> > > for Documentation, and the technical writers are not students but
> > > experienced folks in the filed. Projects can apply directly, it doesn't
> > > have to be through ASF for example.
> > >
> > > To be a mentor in this program, you don't have to be a technical
> writer,
> > > but you must know the product and the open source well to
> > onboard/introduce
> > > tech writers to the project and be able to support them during the
> whole
> > > process.
> > >
> > > I think it will be very beneficial for Airflow to participate, as the
> > > survey also pointed out the need for Docs improvement [2].
> > >
> > > If there is interest, i will be happy to coordinate the application
> > process
> > > and support interested mentors.
> > >
> > > Thanks,
> > > A.
> > >
> > > [1] https://developers.google.com/season-of-docs/docs/timeline
> > > [2]
> > >
> https://ash.berlintaylor.com/writings/2019/02/airflow-user-survey-2019/
> > >
> > > --
> > > Gerardo Curiel // https://gerar.do
> > >
> >
>
>
> --
>
> *Aizhamal Nurmamat kyzy*
>
> Open Source Program Manager
>
> 646-355-9740 Mobile
>
> 601 North 34th Street, Seattle, WA 98103
>

Mime
  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message