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 <aizha...@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 <gtoons...@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 <gera...@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 ( > > > aizha...@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 >
