fritz-astronomer opened a new issue, #60185:
URL: https://github.com/apache/airflow/issues/60185

   ### What do you see as an issue?
   
   `airflow.providers.common.compat.sdk.BaseSensorOperator` is referenced as a 
base, however this is not a clickable anchor
   - 
https://airflow.apache.org/docs/apache-airflow-providers-standard/stable/_api/airflow/providers/standard/sensors/bash/index.html#airflow.providers.standard.sensors.bash.BashSensor
   - 
https://airflow.apache.org/docs/apache-airflow-providers-sftp/5.5.1/_api/airflow/providers/sftp/sensors/sftp/index.html
   
   I was unable to find it in the provider path specified (meaning I couldn't 
see the actual signature of sensors that a sensor inherits)
   
https://airflow.apache.org/docs/apache-airflow-providers-common-compat/stable/_api/airflow/providers/common/compat/standard/operators/index.html
   
   I also was not able to find it on the "Operators and Hooks Reference" in the 
main docs 
   
https://airflow.apache.org/docs/apache-airflow/stable/operators-and-hooks-ref.html
   Note that both `airflow.models.baseoperator` is not a link, nor is 
`airflow.sensors.base` 
   (`BaseSensorOperator` is not listed here, oversight?)
   
   It IS mentioned in the "public interface" page, along with a clickable link 
(apparently it is documented in the task sdk?)
   
https://airflow.apache.org/docs/apache-airflow/stable/public-airflow-interface.html
   
https://airflow.apache.org/docs/task-sdk/stable/api.html#airflow.sdk.BaseSensorOperator
   
   ---
   
   The `Sensors` page is also fairly sparse, not mentioning any of the params 
for altering how sensing happens, and also not linking to docs on params
   
https://airflow.apache.org/docs/apache-airflow/stable/core-concepts/sensors.html
   
   ### Solving the problem
   
   _No response_
   
   ### Anything else
   
   _No response_
   
   ### Are you willing to submit PR?
   
   - [ ] Yes I am willing to submit a PR!
   
   ### Code of Conduct
   
   - [x] I agree to follow this project's [Code of 
Conduct](https://github.com/apache/airflow/blob/main/CODE_OF_CONDUCT.md)
   


-- 
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.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]

Reply via email to