Skip to content

GenericTransfer reference not clickable in templates documentation #62470

@Ajay9704

Description

@Ajay9704

What do you see as an issue?

The reference to airflow.providers.common.sql.operators.generic_transfer.GenericTransfer in the templates documentation is not clickable, even though other operator references on the same page are correctly linked.

This is visible on the main templates reference (https://airflow.apache.org/docs/apache-airflow/stable/templates-ref.html)

On that page:

References like airflow.providers.standard.operators.bash.BashOperator are clickable
But GenericTransfer appears only as plain text, with no link to its documentation

Context

GenericTransfer lives in
airflow.providers.common.sql.operators.generic_transfer

It is referenced in the templates documentation, but Sphinx does not generate a link
(likely due to missing or incorrect cross-reference resolution)

This is similar to the earlier issue reported for BaseSensorOperator (#60185), where the reference was also not clickable because Sphinx could not locate the actual module

Impact

Users cannot navigate from the templates documentation to the actual GenericTransfer class
Documentation becomes inconsistent: some operators link properly, others do not
It makes it difficult for users to inspect available template fields or operator parameters

Solving the problem

This appears to be another cross-reference resolution issue similar to the previous BaseSensorOperator case.

A likely cause is that Sphinx cannot correctly resolve the module path during documentation generation.

The fix may involve:

Ensuring that the provider module path
airflow.providers.common.sql.operators.generic_transfer
is included in the documentation build system

Confirming that autoapi generates documentation for that module

Verifying intersphinx mappings and any overrides in
devel-common/src/docs/provider_conf.py

Making sure the module is not excluded by filters such as autoapi_ignore or docstring-processing rules

Anything else

This appears to be the same class of problem reported in:

Issue #60185 (BaseSensorOperator non-clickable reference)

I looked into this while debugging the BaseSensorOperator issue and noticed similar symptoms.
This might indicate a broader cross-reference / provider documentation configuration gap.

Image Image

Are you willing to submit PR?

  • Yes I am willing to submit a PR!

Code of Conduct

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions