Skip to content

Conversation

@potiuk
Copy link
Member

@potiuk potiuk commented Jul 12, 2023

The #32495 changed the way to run docs - with using --for-production flag, which means that the docs are generated under "stable" link rather than "latest" - in order to test document publishing.

We could change it back to latest, but the problem revealed that we do not have to actually make a distinction there. It's ok to keep it all as "stable" - no problem with that - there is no distinction between latest and stable other than different link and we never mix the two (our production docs have only stable), so it's ok to switch everything to stable.

As a follow-up --for-production flag will be removed and we will switch everything to stable for all documentation building. For now fetching docs from stable link should fix the problem.


^ 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 newsfragments.

The apache#32495 changed the way to run docs - with using --for-production
flag, which means that the docs are generated under "stable" link
rather than "latest" - in order to test document publishing.

We could change it back to latest, but the problem revealed that
we do not have to actually make a distinction there. It's ok
to keep it all as "stable" - no problem with that - there is no
distinction between latest and stable other than different link
and we never mix the two (our production docs have only stable),
so it's ok to switch everything to stable.

As a follow-up `--for-production` flag will be removed and we will
switch everything to stable for all documentation building. For
now fetching docs from stable link should fix the problem.
@potiuk
Copy link
Member Author

potiuk commented Jul 12, 2023

Merging without waiting. It won't get worse.

@potiuk potiuk merged commit f675c4d into apache:main Jul 12, 2023
@potiuk potiuk deleted the fix-fetching-inventory-for-docs branch July 12, 2023 16:28
Copy link
Contributor

@amoghrajesh amoghrajesh left a comment

Choose a reason for hiding this comment

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

Thanks for the quick fix. LGTM +1

potiuk added a commit to potiuk/airflow that referenced this pull request Jul 12, 2023
We had two types of documentation building:
 * latest
 * for production

But in fact they never overlapped and we were never mixing the two
We used the latest for all development work and for production for
releasing to "airflow.apache.org".

However as we saw in apache#32562 (triggered by apache#32495 changing the build
in main to run with `--for-production` flag - we actually do not
need the "latest" builds at all. Everything can be build with
"for production" by default.

This change removes the `--for-production` flag entirely, leaving
the "for production" build mode as the only one available.
potiuk added a commit that referenced this pull request Jul 12, 2023
We had two types of documentation building:
 * latest
 * for production

But in fact they never overlapped and we were never mixing the two
We used the latest for all development work and for production for
releasing to "airflow.apache.org".

However as we saw in #32562 (triggered by #32495 changing the build
in main to run with `--for-production` flag - we actually do not
need the "latest" builds at all. Everything can be build with
"for production" by default.

This change removes the `--for-production` flag entirely, leaving
the "for production" build mode as the only one available.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants