mik-laj commented on a change in pull request #5059: [AIRFLOW-161] New redirect route and extra links URL: https://github.com/apache/airflow/pull/5059#discussion_r278266174
########## File path: docs/howto/operator/define_extra_link.rst ########## @@ -0,0 +1,53 @@ +.. Licensed to the Apache Software Foundation (ASF) under one Review comment: @milton0825 It makes sense, but only all the information about the operators would be in one place. This is not true in this case. I will suggest a different structure because I am concerned that the number of guides on the use of operators will grow rapidly. In this case, the guides about creating a new operator can be easily overlooked when it is just a small sub-point in large list. I would like these fragment in a new page that will contain information on the creation of operators. As a part of SOD 2009, I proposed the project "4. How to create a workflow" and one of its expected deliverables is to create such a page. > A page for developing custom operators that includes: > * Describing mechanisms that are important when creating an operator, such as > template fields, UI color, hooks, connection, etc. > * Describing the responsibility between the operator and the hook > * Considerations for dealing with shared resources (such as connections and hooks) https://cwiki.apache.org/confluence/display/AIRFLOW/Season+of+Docs+2019 As mentors of SOD project, I set a personal goal to improve the structure of the documentation. I agree that the recommendations will be useful and I will try to develop them. I hope my explanations were helpful. ---------------------------------------------------------------- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. For queries about this service, please contact Infrastructure at: [email protected] With regards, Apache Git Services
