feng-tao commented on a change in pull request #4282: [AIRFLOW-XXX] Add 
Docstrings as Requirement in Contribution template
URL: https://github.com/apache/incubator-airflow/pull/4282#discussion_r239212369
 
 

 ##########
 File path: .github/PULL_REQUEST_TEMPLATE.md
 ##########
 @@ -28,6 +28,7 @@ Make sure you have checked _all_ steps below.
 
 - [ ] In case of new functionality, my PR adds documentation that describes 
how to use it.
   - When adding new operators/hooks/sensors, the autoclass documentation 
generation needs to be added.
+  - All the functions and the classes in the PR contain docstrings that 
explain what it does
 
 Review comment:
   I know python doesn't have public/private func. But sometimes we use 
underscore in the beginning of the func to indicate it is a public func. Not 
sure if it is a convention else where. But we could call `All the public 
functions ...` 

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
us...@infra.apache.org


With regards,
Apache Git Services

Reply via email to