Skip to content
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.

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

ci(python): On Python release, trigger docs build after API reference build #17904

Merged
merged 2 commits into from
Jul 27, 2024

Conversation

stinodego
Copy link
Member

@stinodego stinodego commented Jul 27, 2024

Closes #17329

I believe the issue is that the global docs workflow and the Python docs workflow try updating the gh-pages branch simultaneously. This leads to some of the updates being lost, e.g.:

  • A checks out branch
  • B checks out branch
  • A writes to branch
  • B writes to branch (updates from A are lost)

Now the global docs will be built after the Python API docs. That should take care of the issue.

Not super happy with this fix - it introduces some complexity - but it should work.

@github-actions github-actions bot added internal An internal refactor or improvement python Related to Python Polars labels Jul 27, 2024
@@ -51,7 +51,7 @@ jobs:
run: make html

- name: Deploy Python docs for latest development version
if: ${{ github.ref_name == 'main' }}
if: github.event_name == 'push' && github.ref_name == 'main'
Copy link
Member Author

Choose a reason for hiding this comment

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

Drive-by: we don't need to build the dev docs on Python release, as they are already updated with every push to main.

@stinodego stinodego marked this pull request as ready for review July 27, 2024 10:14
@ritchie46 ritchie46 merged commit 3a97d9a into main Jul 27, 2024
6 checks passed
@ritchie46 ritchie46 deleted the fix-docs-deploy branch July 27, 2024 18:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
internal An internal refactor or improvement python Related to Python Polars
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Python releases do not (always) correctly update the user guide
2 participants