airflow-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Ash Berlin-Taylor <...@apache.org>
Subject Re: Airflow for Google Season of Docs 2019
Date Tue, 19 Mar 2019 18:41:30 GMT
I can spare some time to do the on-boarding side of this.

-ash

> On 19 Mar 2019, at 16:58, 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
View raw message