Re: [PLEASE PARTICIPATE] Brainstorming ideas for Season of Docs

Hello everyone, You may have noticed that applicants to SoD are sending direct emails to me. The reason is - Program administrators for SoD have had troubles sending emails to the dev@ list. When anyone sends an email to dev@ list without being subscribed, their messages get bounced back and get l

Re: [PLEASE PARTICIPATE] Brainstorming ideas for Season of Docs

Hello all! I am delighted to announce to the community that our application for Season of Docs got accepted! [1] 🎉🥳👏 Well done everybody! Now technical writers will look into our project ideas and submit their proposals. I’ll keep you updated in the dev list. Cheers, Aizhamal [1] https://list

Re: [PLEASE PARTICIPATE] Brainstorming ideas for Season of Docs

Great! On Tue, Apr 23, 2019 at 7:02 PM Aizhamal Nurmamat kyzy wrote: > We submitted the application. Fingers crossed! > > Accepted mentoring organizations will be announced on April 30, 2019 at > 12:00 UTC. I will update you all in this thread with the results. > > Thanks everybody, > Aizhamal >

Re: [PLEASE PARTICIPATE] Brainstorming ideas for Season of Docs

We submitted the application. Fingers crossed! Accepted mentoring organizations will be announced on April 30, 2019 at 12:00 UTC. I will update you all in this thread with the results. Thanks everybody, Aizhamal On Mon, Apr 22, 2019 at 4:36 PM Aizhamal Nurmamat kyzy wrote: > Hi all, > > +Ash B

Re: [PLEASE PARTICIPATE] Brainstorming ideas for Season of Docs

Hi all, +Ash Berlin-Taylor Could you please confirm, whether you will submit the organization application to SoD *before April 23, 2019 20:00 UTC*? All the information needed in the form are provided in the doc [1]. For all mentors, please don't forget to complete mentor's registration form by t

Re: [PLEASE PARTICIPATE] Brainstorming ideas for Season of Docs

Thank you all for contributing! Our project ideas are looking good :) I published a wiki page with a small message announcing Airflow's participation in SoD and the ideas list that we put together [1]. I also added corresponding Jira issues in the wiki. For mentors: +jgho...@gmail.com +a...@apach

Re: [PLEASE PARTICIPATE] Brainstorming ideas for Season of Docs

To be honest on of the things that is very hard for a first time user in Airflow is to decide which executor to use. It would be extremely helpful if it would be possible to generate a table to compare properties between them. ‐‐‐ Original Message ‐‐‐ On Tuesday, April 9, 2019 10:52 PM,

Re: [PLEASE PARTICIPATE] Brainstorming ideas for Season of Docs

Hi everyone, Here are a few updates on our application for Season of Docs: 1. I updated the document with more descriptions for each project idea and specified the deliverables[1]. 2. To submit our application, we need to publish our project ideas list. For this I will open Jira tickets with “gs

Re: [PLEASE PARTICIPATE] Brainstorming ideas for Season of Docs

One more idea - providing that we will implement AIP-7 Simplified Development Workflow ( https://cwiki.apache.org/confluence/display/AIRFLOW/AIP-7+Simplified+development+workflow) - maybe it would be worthwhile to take a look at updates in the "Contributors" document and "Breeze" documentation. Tha

Re: [PLEASE PARTICIPATE] Brainstorming ideas for Season of Docs

Thank you all for sharing the ideas! We will start moving them to a separate doc and start scoping each idea with mentors. If you have more ideas, keep posting in this thread. Thank you, Aizhamal On Wed, Apr 10, 2019 at 6:34 AM Driesprong, Fokko wrote: > Thanks Aizhamal for opening the discu

Re: [PLEASE PARTICIPATE] Brainstorming ideas for Season of Docs

Thanks Aizhamal for opening the discussion. I would like to see more documentation on the Kubernetes executor, which is under heavy development, but the documentation is still lacking. I would love to see some more extended documentation on how to set it up, and how to make the most out of it. I t

Re: [PLEASE PARTICIPATE] Brainstorming ideas for Season of Docs

+1 for using plantuml On Wed, Apr 10, 2019, 10:19 Kamil Gałuszka wrote: > In matter of documentation it would be nice to add PlantUML to Sphinx, so > we can visualise a lot of complexities of Airflow (see here: > https://pypi.org/project/sphinxcontrib-plantuml/). > > Especially that sometimes on

Re: [PLEASE PARTICIPATE] Brainstorming ideas for Season of Docs

In matter of documentation it would be nice to add PlantUML to Sphinx, so we can visualise a lot of complexities of Airflow (see here: https://pypi.org/project/sphinxcontrib-plantuml/). Especially that sometimes one diagram can speak much clearly than wall of text. Not sure how others see that, b

Re: [PLEASE PARTICIPATE] Brainstorming ideas for Season of Docs

- The structure of the documentation requires rethinking. A lot of information is contained on one subpage - "concepts". Some information should not be on this subpage e.x. .airflowignore Other information should be extended, but then they will occupy too much space on this page e. x. creating rela

Re: [PLEASE PARTICIPATE] Brainstorming ideas for Season of Docs

- Deployment in {AWS, Azure, GCP} - Monitoring, health checks, etc - Best practices for {dags, subdags, dag scheduling} Gerard Toonstra has some amazing docs here for some of these topics as well: https://gtoonstra.github.io/etl-with-airflow/ On 10

Re: [PLEASE PARTICIPATE] Brainstorming ideas for Season of Docs

- how to configure different types of connections - how to rerun a failed task. - tips for designing dags - writing custom operators (or tweaking the behaviour of a built-in one) without needing plug in. Ash On 9 April 2019 20:52:02 BST, Aizhamal Nurmamat kyzy wrote: >Hello all, > >Let's put t

[PLEASE PARTICIPATE] Brainstorming ideas for Season of Docs

Hello all, Let's put together ideas for the Season of Docs. Can you please share any documentation pain points that you are aware of as a user or as a contributor? Anything where you think the Airflow docs could be improved significantly? Some ideas that members of the community have shared with