Skip to content

GH-46956: [Docs][CI] Enable version switcher in local and PR preview build #46957

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

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

AlenkaF
Copy link
Member

@AlenkaF AlenkaF commented Jul 1, 2025

Rationale for this change

Currently, the version switcher is not functional in local builds or in PR preview docs via crossbow, since it relies on the versions.json file from the arrow site.

This makes it difficult to test changes to the switcher configuration or verify that nothing breaks with new theme updates.

What changes are included in this PR?

The version switcher is enabled in a dev setup by:

  • Using online versions.json file when building locally or in PR preview
  • Falling back to the arrow-site JSON otherwise

Are these changes tested?

Yes, preview-docs build.

Are there any user-facing changes?

No, only local testing is simplified.


if docs_dev == "1":
json_url = "https://arrow.apache.org/docs/_static/versions.json"
# json_url = "_static/versions.json"
Copy link
Member Author

Choose a reason for hiding this comment

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

Using the local relative path here doesn't work as expected, so the online https:// URL is used for now.

@AlenkaF
Copy link
Member Author

AlenkaF commented Jul 1, 2025

@github-actions crossbow submit preview-docs

@github-actions github-actions bot added awaiting committer review Awaiting committer review and removed awaiting review Awaiting review labels Jul 1, 2025
Copy link

github-actions bot commented Jul 1, 2025

Revision: 890cb6e

Submitted crossbow builds: ursacomputing/crossbow @ actions-119dd58bd4

Task Status
preview-docs GitHub Actions

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.

1 participant