Skip to content

Docs: Resolve task-sdk vs publish-docs contradiction#64648

Closed
liamkernan wants to merge 2 commits intoapache:mainfrom
liamkernan:docs-task-sdk-publish-instructions
Closed

Docs: Resolve task-sdk vs publish-docs contradiction#64648
liamkernan wants to merge 2 commits intoapache:mainfrom
liamkernan:docs-task-sdk-publish-instructions

Conversation

@liamkernan
Copy link
Copy Markdown
Contributor

Summary

Closes #64350.

The documentation building guide describes task-sdk/docs as not yet published, while the release README listed task-sdk alongside apache-airflow and docker-stack in publish-docs examples. This updates the release instructions to match reality and points readers to where Task SDK docs stand.

Changes

  • dev/README_RELEASE_AIRFLOW.md: use apache-airflow docker-stack only in publish-docs examples; add a short note that Task SDK documentation is not published through this workflow yet.
  • contributing-docs/11_documentation_building.rst: clarify that the release publish-docs steps do not include Task SDK docs yet.

Was generative AI tooling used to co-author this PR?
  • Yes
  • No

Made with Cursor

Remove task-sdk from publish-docs examples in the release README and document
that Task SDK docs are not published through that workflow yet. Cross-link
from the documentation building guide.

Signed-off-by: Liam <liamkernan0@gmail.com>
@boring-cyborg boring-cyborg bot added area:dev-tools backport-to-v3-2-test Mark PR with this label to backport to v3-2-test branch labels Apr 2, 2026
Signed-off-by: Liam <liamkernan0@gmail.com>
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No need to a newfragment in this case. Only if major changes are made a newsfragment is needed. Please remove.

* ``providers/**/docs`` - documentation for Providers
* ``chart/docs`` - documentation for Helm Chart
* ``task-sdk/docs`` - documentation for Task SDK (new format not yet published)
* ``task-sdk/docs`` - documentation for Task SDK (new format not yet published on the site). The
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Task SDK is actually being published in https://airflow.apache.org/docs/task-sdk/stable/index.html

@potiuk potiuk closed this Apr 6, 2026
@potiuk
Copy link
Copy Markdown
Member

potiuk commented Apr 6, 2026

this

@liamkernan liamkernan deleted the docs-task-sdk-publish-instructions branch April 7, 2026 17:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:dev-tools backport-to-v3-2-test Mark PR with this label to backport to v3-2-test branch

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Resolve contradiction in task-sdk publishing instructions

3 participants