You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@airflow.apache.org by GitBox <gi...@apache.org> on 2020/08/05 17:17:47 UTC
[GitHub] [airflow] potiuk opened a new issue #10180: Move
potiuk opened a new issue #10180:
URL: https://github.com/apache/airflow/issues/10180
**Description**
The old documentation for [Common Pitfalls](https://cwiki.apache.org/confluence/pages/viewpage.action?pageId=62694614) should be reviewed and incorporated in [Airflow Docs](https://github.com/apache/airflow/tree/master/docs)
**Use case / motivation**
To remove documentation duplication and clean it up.
**Related Issues**
#10178
----------------------------------------------------------------
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:
users@infra.apache.org
[GitHub] [airflow] wolfier commented on issue #10180: Review and move Common Pitfalls Documentation to Airflow Docs
Posted by GitBox <gi...@apache.org>.
wolfier commented on issue #10180:
URL: https://github.com/apache/airflow/issues/10180#issuecomment-786817374
I haven't seen any activity on this so I will be taking this issue.
----------------------------------------------------------------
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:
users@infra.apache.org
[GitHub] [airflow] potiuk commented on issue #10180: Review and move Common Pitfalls Documentation to Airflow Docs
Posted by GitBox <gi...@apache.org>.
potiuk commented on issue #10180:
URL: https://github.com/apache/airflow/issues/10180#issuecomment-683397925
I've assigned it to you
----------------------------------------------------------------
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:
users@infra.apache.org
[GitHub] [airflow] kaxil closed issue #10180: Review and move Common Pitfalls Documentation to Airflow Docs
Posted by GitBox <gi...@apache.org>.
kaxil closed issue #10180:
URL: https://github.com/apache/airflow/issues/10180
--
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:
users@infra.apache.org
[GitHub] [airflow] bsnithin44 commented on issue #10180: Review and move Common Pitfalls Documentation to Airflow Docs
Posted by GitBox <gi...@apache.org>.
bsnithin44 commented on issue #10180:
URL: https://github.com/apache/airflow/issues/10180#issuecomment-674545982
I would be happy to pick this up,
But could someone give me a little context on documentation duplication?. Any guidance would be much appreciated.
Thanks
----------------------------------------------------------------
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:
users@infra.apache.org
[GitHub] [airflow] potiuk commented on issue #10180: Review and move Common Pitfalls Documentation to Airflow Docs
Posted by GitBox <gi...@apache.org>.
potiuk commented on issue #10180:
URL: https://github.com/apache/airflow/issues/10180#issuecomment-683397890
Hello - just see the message now. Sorry I missed it :(
The context - we had a lot of documentation which was split into several different sources - Github docs, Cwiki, Airflow documentation in docs. Airflow Site and sometimes the documentation was overlapping, sometimes outdated, sometimes it did not contain relevant information.
We are now cleaning and restructuring the docs to be more consistent. It's mostly based on who the "Readers" of the documentation are:
* Airflow Docs - those are mostly the users of Airflow. People who either want to setup and manage Airlfow or those who want to write Dags or develop custom operators/Hooks etc. .
* Github Docs - Contributors and Committers. Basically, developers of Airflow
* Airlfow Site - mostly decision makers, those who would like to understand whether Airflow is a good choice for them. Also people who want to learn Airflow and decide whether they shoudl become users or contributors or both. Basically this should be index of "Everything Airflow" and a starting point for everything else.
* CWiki - we keep it mostly for AIPs (Airflow Improvement Proposals). But it's very likely (discussion https://lists.apache.org/thread.html/rf58348edc3ed4ad8dd167cdbeda0a2a5219a2ab1725d4e1b7e980d9a%40%3Cdev.airflow.apache.org%3E) we will get rid of it completely and move all the new AIPs to Github Issues.
The common pitfalls doc clearly belongs to the "Airlfow Docs" (readership = users of Airflow). I think there should be a page in the Airflow Documentation with Common Pftfalls. And I believe it is enough to make a PR as starting point with the content of the original document in CWiki and you will get plenty of comments from the community and suggestions what else to add ...
----------------------------------------------------------------
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:
users@infra.apache.org