Skip to content

Conversation

@potiuk
Copy link
Member

@potiuk potiuk commented Jan 5, 2026

We have been using rather brittle approach to re-publish docs when we had to apply some changes to the released documentation (such as formatting changes or typo fixes). We had to remember about those cherry-picks to apply them again in case of re-re-publish and of course - we forgot.

This PR adds a better process for that that can be followed by the release manager easily - and such re-publishing of the docs will be tracked in a new TAG-docs branch that we should create and release the documentation from - those branches will track any changes already applied and any re-re-re*-publishing will be based on the previous re-re*publishing.


^ Add meaningful description above
Read the Pull Request Guidelines for more information.
In case of fundamental code changes, an Airflow Improvement Proposal (AIP) is needed.
In case of a new dependency, check compliance with the ASF 3rd Party License Policy.
In case of backwards incompatible changes please leave a note in a newsfragment file, named {pr_number}.significant.rst or {issue_number}.significant.rst, in airflow-core/newsfragments.

We have been using rather brittle approach to re-publish docs
when we had to apply some changes to the released documentation
(such as formatting changes or typo fixes). We had to remember
about those cherry-picks to apply them again in case of re-re-publish
and of course - we forgot.

This PR adds a better process for that that can be followed by the
release manager easily - and such re-publishing of the docs will
be tracked in a new `TAG-docs` branch that we should create and
release the documentation from - those branches will track any
changes already applied and any re-re-re*-publishing will be based
on the previous re-re*publishing.
@potiuk potiuk merged commit 9fba01e into apache:main Jan 5, 2026
70 checks passed
@potiuk potiuk deleted the better-process-to-fix-documentation branch January 5, 2026 23:40
@github-actions
Copy link

github-actions bot commented Jan 5, 2026

Backport failed to create: v3-1-test. View the failure log Run details

Status Branch Result
v3-1-test Commit Link

You can attempt to backport this manually by running:

cherry_picker 9fba01e v3-1-test

This should apply the commit to the v3-1-test branch and leave the commit in conflict state marking
the files that need manual conflict resolution.

After you have resolved the conflicts, you can continue the backport process by running:

cherry_picker --continue

chirodip98 pushed a commit to chirodip98/airflow-contrib that referenced this pull request Jan 9, 2026
We have been using rather brittle approach to re-publish docs
when we had to apply some changes to the released documentation
(such as formatting changes or typo fixes). We had to remember
about those cherry-picks to apply them again in case of re-re-publish
and of course - we forgot.

This PR adds a better process for that that can be followed by the
release manager easily - and such re-publishing of the docs will
be tracked in a new `TAG-docs` branch that we should create and
release the documentation from - those branches will track any
changes already applied and any re-re-re*-publishing will be based
on the previous re-re*publishing.
stegololz pushed a commit to stegololz/airflow that referenced this pull request Jan 9, 2026
We have been using rather brittle approach to re-publish docs
when we had to apply some changes to the released documentation
(such as formatting changes or typo fixes). We had to remember
about those cherry-picks to apply them again in case of re-re-publish
and of course - we forgot.

This PR adds a better process for that that can be followed by the
release manager easily - and such re-publishing of the docs will
be tracked in a new `TAG-docs` branch that we should create and
release the documentation from - those branches will track any
changes already applied and any re-re-re*-publishing will be based
on the previous re-re*publishing.
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-1-test Mark PR with this label to backport to v3-1-test branch

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants