Skip to content

docs: update public interface doc to reflect airflow.sdk and AIP-72 #52197

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Open
wants to merge 4 commits into
base: main
Choose a base branch
from
Open

docs: update public interface doc to reflect airflow.sdk and AIP-72 #52197

wants to merge 4 commits into from

Conversation

nrnavaneet
Copy link

Summary

Updated the public-airflow-interface.rst documentation to reflect changes introduced in Apache Airflow 3.0.

  • Added a note under "Using Airflow Public Interfaces" highlighting the airflow.sdk namespace.
  • Encouraged use of the official REST API and Python Client SDK for stable integrations.
  • Linked AIP-72 and relevant release notes for clarity.

Related Issue

Closes #52159

@nrnavaneet
docs: update public interface doc to reflect airflow.sdk and AIP-72
3af3ead 
- Added a note under "Using Airflow Public Interfaces" to recommend using `airflow.sdk` as the official interface from Airflow 3.0.
- Referenced AIP-72 and linked related documentation.
- Encouraged users to prefer REST API and Python Client for integrations.
@boring-cyborg boring-cyborg
Copy link

boring-cyborg bot commented Jun 24, 2025

Congratulations on your first Pull Request and welcome to the Apache Airflow community! If you have any issues or are unsure about any anything please check our Contributors' Guide (https://github.com/apache/airflow/blob/main/contributing-docs/README.rst)
Here are some useful points:

  • Pay attention to the quality of your code (ruff, mypy and type annotations). Our pre-commits will help you with that.
  • In case of a new feature add useful documentation (in docstrings or in docs/ directory). Adding a new operator? Check this short guide Consider adding an example DAG that shows how users should use it.
  • Consider using Breeze environment for testing locally, it's a heavy docker but it ships with a working Airflow and a lot of integrations.
  • Be patient and persistent. It might take some time to get a review or get the final approval from Committers.
  • Please follow ASF Code of Conduct for all communication including (but not limited to) comments on Pull Requests, Mailing list and Slack.
  • Be sure to read the Airflow Coding style.
  • Always keep your Pull Requests rebased, otherwise your build might fail due to changes not related to your commits.
    Apache Airflow is a community-driven project and together we are making it better 🚀.
    In case of doubts contact the developers at:
    Mailing List: [email protected]
    Slack: https://s.apache.org/airflow-slack

@nrnavaneet
Copy link
Author

Hi! 🙌 First-time contributor here. Thanks for reviewing this PR — happy to make any improvements if needed!

potiuk
potiuk reviewed Jun 25, 2025
View reviewed changes
@nrnavaneet nrnavaneet force-pushed the update-public-interface-docs branch from a4b3ae7 to 0538d94 Compare June 26, 2025 16:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Reviewers

@potiuk potiuk potiuk approved these changes

Assignees
No one assigned
Labels
kind:documentation
Projects
None yet
Milestone
No milestone
Development

Successfully merging this pull request may close these issues.

Helm Notes Adjustment for Airflow Version >= 3.0.0
2 participants
@nrnavaneet @potiuk