mik-laj edited a comment on pull request #11212: URL: https://github.com/apache/airflow/pull/11212#issuecomment-703130527
@iadi7ya The examples in the guides are very helpful and even required. We expect that users will be able to run these examples immediately after reading the guide. Is there no sample use of this operator in tests? Maybe you will be able to create a suitable example DAG based on this? In the case of guides for Google, we have even greater requirements. For Google, each guide has its own example DAG, but also system tests that run this DAG to validate it. If in the guide it is necessary to create additional resources, e.g. GCS buckets, they are also created by automatic scripts. In the case of Apache, this is not necessary, but I would like to show you some context why it is important to me that an example DAG be added.I try to make sure that each guide is of good quality. Not everyone has to meet all the requirements, but there are some rules that we try to follow in the guides. We don't have general rules for how-to guides, but most of the tips for Google can apply to other services too. You can read the recommendations for Google guides: [Google Operators Docs Guide](https://docs.google.com/document/d/1RLQiuADIX00uGh0Llfcvv8WyCcayD6Cwkx4MNnHvDOc/edit#heading=h.wchyosj84oht) and [Google developer documentation style guide](https://developers.google.com/style) ---------------------------------------------------------------- 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]
