Ajay9704 opened a new pull request, #60203:
URL: https://github.com/apache/airflow/pull/60203

   ## Summary
   This PR resolves issue #60185 where BaseSensorOperator wasn't clickable in 
provider documentation, making it hard to find information about sensor 
parameters.
   
   ## The Problem
   I discovered that BaseSensorOperator lives in the new Task SDK at 
airflow/task-sdk/src/airflow/sdk/bases/sensor.py, but when building 
documentation for providers, the system only scanned the current provider's 
source code. This meant that when providers like the standard sensors 
referenced BaseSensorOperator, the documentation couldn't create proper links 
to the actual class definition.
   
   ## My Approach
   I modified airflow/devel-common/src/docs/provider_conf.py to:
   - Add the task-sdk source path to the autoapi directories so provider docs 
can access SDK classes
   - Set up proper intersphinx mapping to link to task-sdk documentation
   - Include safeguards to prevent any conflicts between documentation sources
   
   ## Testing Done
   I verified that:
   - Documentation builds still work properly with these changes
   - The links now work correctly in provider documentation
   - No existing functionality is broken
   - The fix is isolated to just the documentation generation process
   
   ## Impact
   This change means users can now click on BaseSensorOperator references in 
provider documentation and jump directly to the class definition to see all 
available parameters and methods. Much more user-friendly


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