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

[docs] fix version picker selected version #50292

Merged
merged 2 commits into from
Feb 11, 2025

Conversation

cristianjd
Copy link
Collaborator

@cristianjd cristianjd commented Feb 6, 2025

Why are these changes needed?

The version picker was not properly respecting the selected version. This is due to the generated versions in the json being incorrect.

Fixed by updating the json generation logic to use versions of the form releases-2.42.0 instead releases/2.24.0 and updated the version match logic in conf.py back to just reading the version directly

Before:
Screenshot 2025-02-06 at 12 31 55 PM

After:
Screenshot 2025-02-06 at 12 31 19 PM

Checks

  • I've signed off every commit(by using the -s flag, i.e., git commit -s) in this PR.
  • I've run scripts/format.sh to lint the changes in this PR.
  • I've included any doc changes needed for https://docs.ray.io/en/master/.
    • I've added any new APIs to the API Reference. For example, if I added a
      method in Tune, I've added it in doc/source/tune/api/ under the
      corresponding .rst file.
  • I've made sure the tests are passing. Note that there might be a few flaky tests, see the recent failures at https://flakey-tests.ray.io/
  • Testing Strategy
    • Unit tests
    • Release tests
    • This PR is not tested :(

Signed-off-by: cristianjd <cristian.j.derr@gmail.com>
@cristianjd cristianjd requested a review from a team as a code owner February 6, 2025 20:38
doc/source/conf.py Outdated Show resolved Hide resolved
@aslonnie aslonnie removed the request for review from can-anyscale February 10, 2025 18:28
Signed-off-by: cristianjd <cristian.j.derr@gmail.com>
Copy link
Contributor

@angelinalg angelinalg left a comment

Choose a reason for hiding this comment

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

stamp

@pcmoritz pcmoritz enabled auto-merge (squash) February 11, 2025 02:02
@github-actions github-actions bot added the go add ONLY when ready to merge, run all tests label Feb 11, 2025
@pcmoritz pcmoritz merged commit 2efae28 into master Feb 11, 2025
7 checks passed
@pcmoritz pcmoritz deleted the cristian/fix-version-picker-select branch February 11, 2025 02:54
cristianjd added a commit that referenced this pull request Feb 11, 2025
## Why are these changes needed?
The version picker was not properly respecting the selected version.
This is due to the generated versions in the json being incorrect.

Fixed by updating the json generation logic to use versions of the form
`releases-2.42.0` instead `releases/2.24.0` and updated the version
match logic in `conf.py` back to just reading the version directly

Before:
![Screenshot 2025-02-06 at 12 31
55 PM](https://github.com/user-attachments/assets/7ca7669e-8a71-4612-b875-94955ed955fd)

After:
![Screenshot 2025-02-06 at 12 31
19 PM](https://github.com/user-attachments/assets/928581b8-2360-4b18-a87c-3b670212165e)



## Checks

- [x] I've signed off every commit(by using the -s flag, i.e., `git
commit -s`) in this PR.
- [x] I've run `scripts/format.sh` to lint the changes in this PR.
- [ ] I've included any doc changes needed for
https://docs.ray.io/en/master/.
- [ ] I've added any new APIs to the API Reference. For example, if I
added a
method in Tune, I've added it in `doc/source/tune/api/` under the
           corresponding `.rst` file.
- [ ] I've made sure the tests are passing. Note that there might be a
few flaky tests, see the recent failures at https://flakey-tests.ray.io/
- Testing Strategy
   - [ ] Unit tests
   - [ ] Release tests
   - [ ] This PR is not tested :(

---------

Signed-off-by: cristianjd <cristian.j.derr@gmail.com>
cristianjd added a commit that referenced this pull request Feb 11, 2025
## Why are these changes needed?
The version picker was not properly respecting the selected version.
This is due to the generated versions in the json being incorrect.

Fixed by updating the json generation logic to use versions of the form
`releases-2.42.0` instead `releases/2.24.0` and updated the version
match logic in `conf.py` back to just reading the version directly

Before:
![Screenshot 2025-02-06 at 12 31
55 PM](https://github.com/user-attachments/assets/7ca7669e-8a71-4612-b875-94955ed955fd)

After:
![Screenshot 2025-02-06 at 12 31
19 PM](https://github.com/user-attachments/assets/928581b8-2360-4b18-a87c-3b670212165e)



## Checks

- [x] I've signed off every commit(by using the -s flag, i.e., `git
commit -s`) in this PR.
- [x] I've run `scripts/format.sh` to lint the changes in this PR.
- [ ] I've included any doc changes needed for
https://docs.ray.io/en/master/.
- [ ] I've added any new APIs to the API Reference. For example, if I
added a
method in Tune, I've added it in `doc/source/tune/api/` under the
           corresponding `.rst` file.
- [ ] I've made sure the tests are passing. Note that there might be a
few flaky tests, see the recent failures at https://flakey-tests.ray.io/
- Testing Strategy
   - [ ] Unit tests
   - [ ] Release tests
   - [ ] This PR is not tested :(

---------

Signed-off-by: cristianjd <cristian.j.derr@gmail.com>
cristianjd added a commit that referenced this pull request Feb 11, 2025
## Why are these changes needed?
The version picker was not properly respecting the selected version.
This is due to the generated versions in the json being incorrect.

Fixed by updating the json generation logic to use versions of the form
`releases-2.42.0` instead `releases/2.24.0` and updated the version
match logic in `conf.py` back to just reading the version directly

Before:
![Screenshot 2025-02-06 at 12 31
55 PM](https://github.com/user-attachments/assets/7ca7669e-8a71-4612-b875-94955ed955fd)

After:
![Screenshot 2025-02-06 at 12 31
19 PM](https://github.com/user-attachments/assets/928581b8-2360-4b18-a87c-3b670212165e)



## Checks

- [x] I've signed off every commit(by using the -s flag, i.e., `git
commit -s`) in this PR.
- [x] I've run `scripts/format.sh` to lint the changes in this PR.
- [ ] I've included any doc changes needed for
https://docs.ray.io/en/master/.
- [ ] I've added any new APIs to the API Reference. For example, if I
added a
method in Tune, I've added it in `doc/source/tune/api/` under the
           corresponding `.rst` file.
- [ ] I've made sure the tests are passing. Note that there might be a
few flaky tests, see the recent failures at https://flakey-tests.ray.io/
- Testing Strategy
   - [ ] Unit tests
   - [ ] Release tests
   - [ ] This PR is not tested :(

---------

Signed-off-by: cristianjd <cristian.j.derr@gmail.com>
cristianjd added a commit that referenced this pull request Feb 11, 2025
## Why are these changes needed?
The version picker was not properly respecting the selected version.
This is due to the generated versions in the json being incorrect.

Fixed by updating the json generation logic to use versions of the form
`releases-2.42.0` instead `releases/2.24.0` and updated the version
match logic in `conf.py` back to just reading the version directly

Before:
![Screenshot 2025-02-06 at 12 31
55 PM](https://github.com/user-attachments/assets/7ca7669e-8a71-4612-b875-94955ed955fd)

After:
![Screenshot 2025-02-06 at 12 31
19 PM](https://github.com/user-attachments/assets/928581b8-2360-4b18-a87c-3b670212165e)



## Checks

- [x] I've signed off every commit(by using the -s flag, i.e., `git
commit -s`) in this PR.
- [x] I've run `scripts/format.sh` to lint the changes in this PR.
- [ ] I've included any doc changes needed for
https://docs.ray.io/en/master/.
- [ ] I've added any new APIs to the API Reference. For example, if I
added a
method in Tune, I've added it in `doc/source/tune/api/` under the
           corresponding `.rst` file.
- [ ] I've made sure the tests are passing. Note that there might be a
few flaky tests, see the recent failures at https://flakey-tests.ray.io/
- Testing Strategy
   - [ ] Unit tests
   - [ ] Release tests
   - [ ] This PR is not tested :(

---------

Signed-off-by: cristianjd <cristian.j.derr@gmail.com>
cristianjd added a commit that referenced this pull request Feb 11, 2025
## Why are these changes needed?
The version picker was not properly respecting the selected version.
This is due to the generated versions in the json being incorrect.

Fixed by updating the json generation logic to use versions of the form
`releases-2.42.0` instead `releases/2.24.0` and updated the version
match logic in `conf.py` back to just reading the version directly

Before:
![Screenshot 2025-02-06 at 12 31
55 PM](https://github.com/user-attachments/assets/7ca7669e-8a71-4612-b875-94955ed955fd)

After:
![Screenshot 2025-02-06 at 12 31
19 PM](https://github.com/user-attachments/assets/928581b8-2360-4b18-a87c-3b670212165e)



## Checks

- [x] I've signed off every commit(by using the -s flag, i.e., `git
commit -s`) in this PR.
- [x] I've run `scripts/format.sh` to lint the changes in this PR.
- [ ] I've included any doc changes needed for
https://docs.ray.io/en/master/.
- [ ] I've added any new APIs to the API Reference. For example, if I
added a
method in Tune, I've added it in `doc/source/tune/api/` under the
           corresponding `.rst` file.
- [ ] I've made sure the tests are passing. Note that there might be a
few flaky tests, see the recent failures at https://flakey-tests.ray.io/
- Testing Strategy
   - [ ] Unit tests
   - [ ] Release tests
   - [ ] This PR is not tested :(

---------

Signed-off-by: cristianjd <cristian.j.derr@gmail.com>
cristianjd added a commit that referenced this pull request Feb 11, 2025
## Why are these changes needed?
The version picker was not properly respecting the selected version.
This is due to the generated versions in the json being incorrect.

Fixed by updating the json generation logic to use versions of the form
`releases-2.42.0` instead `releases/2.24.0` and updated the version
match logic in `conf.py` back to just reading the version directly

Before:
![Screenshot 2025-02-06 at 12 31
55 PM](https://github.com/user-attachments/assets/7ca7669e-8a71-4612-b875-94955ed955fd)

After:
![Screenshot 2025-02-06 at 12 31
19 PM](https://github.com/user-attachments/assets/928581b8-2360-4b18-a87c-3b670212165e)



## Checks

- [x] I've signed off every commit(by using the -s flag, i.e., `git
commit -s`) in this PR.
- [x] I've run `scripts/format.sh` to lint the changes in this PR.
- [ ] I've included any doc changes needed for
https://docs.ray.io/en/master/.
- [ ] I've added any new APIs to the API Reference. For example, if I
added a
method in Tune, I've added it in `doc/source/tune/api/` under the
           corresponding `.rst` file.
- [ ] I've made sure the tests are passing. Note that there might be a
few flaky tests, see the recent failures at https://flakey-tests.ray.io/
- Testing Strategy
   - [ ] Unit tests
   - [ ] Release tests
   - [ ] This PR is not tested :(

---------

Signed-off-by: cristianjd <cristian.j.derr@gmail.com>
cristianjd added a commit that referenced this pull request Feb 11, 2025
## Why are these changes needed?
The version picker was not properly respecting the selected version.
This is due to the generated versions in the json being incorrect.

Fixed by updating the json generation logic to use versions of the form
`releases-2.42.0` instead `releases/2.24.0` and updated the version
match logic in `conf.py` back to just reading the version directly

Before:
![Screenshot 2025-02-06 at 12 31
55 PM](https://github.com/user-attachments/assets/7ca7669e-8a71-4612-b875-94955ed955fd)

After:
![Screenshot 2025-02-06 at 12 31
19 PM](https://github.com/user-attachments/assets/928581b8-2360-4b18-a87c-3b670212165e)



## Checks

- [x] I've signed off every commit(by using the -s flag, i.e., `git
commit -s`) in this PR.
- [x] I've run `scripts/format.sh` to lint the changes in this PR.
- [ ] I've included any doc changes needed for
https://docs.ray.io/en/master/.
- [ ] I've added any new APIs to the API Reference. For example, if I
added a
method in Tune, I've added it in `doc/source/tune/api/` under the
           corresponding `.rst` file.
- [ ] I've made sure the tests are passing. Note that there might be a
few flaky tests, see the recent failures at https://flakey-tests.ray.io/
- Testing Strategy
   - [ ] Unit tests
   - [ ] Release tests
   - [ ] This PR is not tested :(

---------

Signed-off-by: cristianjd <cristian.j.derr@gmail.com>
cristianjd added a commit that referenced this pull request Feb 11, 2025
## Why are these changes needed?
The version picker was not properly respecting the selected version.
This is due to the generated versions in the json being incorrect.

Fixed by updating the json generation logic to use versions of the form
`releases-2.42.0` instead `releases/2.24.0` and updated the version
match logic in `conf.py` back to just reading the version directly

Before:
![Screenshot 2025-02-06 at 12 31
55 PM](https://github.com/user-attachments/assets/7ca7669e-8a71-4612-b875-94955ed955fd)

After:
![Screenshot 2025-02-06 at 12 31
19 PM](https://github.com/user-attachments/assets/928581b8-2360-4b18-a87c-3b670212165e)



## Checks

- [x] I've signed off every commit(by using the -s flag, i.e., `git
commit -s`) in this PR.
- [x] I've run `scripts/format.sh` to lint the changes in this PR.
- [ ] I've included any doc changes needed for
https://docs.ray.io/en/master/.
- [ ] I've added any new APIs to the API Reference. For example, if I
added a
method in Tune, I've added it in `doc/source/tune/api/` under the
           corresponding `.rst` file.
- [ ] I've made sure the tests are passing. Note that there might be a
few flaky tests, see the recent failures at https://flakey-tests.ray.io/
- Testing Strategy
   - [ ] Unit tests
   - [ ] Release tests
   - [ ] This PR is not tested :(

---------

Signed-off-by: cristianjd <cristian.j.derr@gmail.com>
pcmoritz pushed a commit that referenced this pull request Feb 11, 2025
This cherry picks #50292 to
release 2.42.0 so the version picker correctly respects the selected
version

## Why are these changes needed?
The version picker was not properly respecting the selected version.
This is due to the generated versions in the json being incorrect.

Fixed by updating the json generation logic to use versions of the form
`releases-2.42.0` instead `releases/2.24.0` and updated the version
match logic in `conf.py` back to just reading the version directly

Before:
![Screenshot 2025-02-06 at 12 31

55 PM](https://github.com/user-attachments/assets/7ca7669e-8a71-4612-b875-94955ed955fd)

After:
![Screenshot 2025-02-06 at 12 31

19 PM](https://github.com/user-attachments/assets/928581b8-2360-4b18-a87c-3b670212165e)



## Checks

- [x] I've signed off every commit(by using the -s flag, i.e., `git
commit -s`) in this PR.
- [x] I've run `scripts/format.sh` to lint the changes in this PR.
- [ ] I've included any doc changes needed for
https://docs.ray.io/en/master/.
- [ ] I've added any new APIs to the API Reference. For example, if I
added a
method in Tune, I've added it in `doc/source/tune/api/` under the
           corresponding `.rst` file.
- [ ] I've made sure the tests are passing. Note that there might be a
few flaky tests, see the recent failures at https://flakey-tests.ray.io/
- Testing Strategy
   - [ ] Unit tests
   - [ ] Release tests
   - [ ] This PR is not tested :(

---------

<!-- Thank you for your contribution! Please review
https://github.com/ray-project/ray/blob/master/CONTRIBUTING.rst before
opening a pull request. -->

<!-- Please add a reviewer to the assignee section when you create a PR.
If you don't have the access to it, we will shortly find a reviewer and
assign them to your PR. -->

## Why are these changes needed?

<!-- Please give a short summary of the change and the problem this
solves. -->

## Related issue number

<!-- For example: "Closes #1234" -->

## Checks

- [ ] I've signed off every commit(by using the -s flag, i.e., `git
commit -s`) in this PR.
- [ ] I've run `scripts/format.sh` to lint the changes in this PR.
- [ ] I've included any doc changes needed for
https://docs.ray.io/en/master/.
- [ ] I've added any new APIs to the API Reference. For example, if I
added a
method in Tune, I've added it in `doc/source/tune/api/` under the
           corresponding `.rst` file.
- [ ] I've made sure the tests are passing. Note that there might be a
few flaky tests, see the recent failures at https://flakey-tests.ray.io/
- Testing Strategy
   - [ ] Unit tests
   - [ ] Release tests
   - [ ] This PR is not tested :(

Signed-off-by: cristianjd <cristian.j.derr@gmail.com>
pcmoritz pushed a commit that referenced this pull request Feb 11, 2025
Cherry picks the following PRs to version 2.41.0 to fix version switcher
issues

#49892
#50292

## Checks

- [ ] I've signed off every commit(by using the -s flag, i.e., `git
commit -s`) in this PR.
- [ ] I've run `scripts/format.sh` to lint the changes in this PR.
- [ ] I've included any doc changes needed for
https://docs.ray.io/en/master/.
- [ ] I've added any new APIs to the API Reference. For example, if I
added a
method in Tune, I've added it in `doc/source/tune/api/` under the
           corresponding `.rst` file.
- [ ] I've made sure the tests are passing. Note that there might be a
few flaky tests, see the recent failures at https://flakey-tests.ray.io/
- Testing Strategy
   - [ ] Unit tests
   - [ ] Release tests
   - [ ] This PR is not tested :(

---------

Signed-off-by: cristianjd <cristian.j.derr@gmail.com>
cristianjd added a commit that referenced this pull request Feb 12, 2025
## Why are these changes needed?
The version picker was not properly respecting the selected version.
This is due to the generated versions in the json being incorrect.

Fixed by updating the json generation logic to use versions of the form
`releases-2.42.0` instead `releases/2.24.0` and updated the version
match logic in `conf.py` back to just reading the version directly

Before:
![Screenshot 2025-02-06 at 12 31
55 PM](https://github.com/user-attachments/assets/7ca7669e-8a71-4612-b875-94955ed955fd)

After:
![Screenshot 2025-02-06 at 12 31
19 PM](https://github.com/user-attachments/assets/928581b8-2360-4b18-a87c-3b670212165e)



## Checks

- [x] I've signed off every commit(by using the -s flag, i.e., `git
commit -s`) in this PR.
- [x] I've run `scripts/format.sh` to lint the changes in this PR.
- [ ] I've included any doc changes needed for
https://docs.ray.io/en/master/.
- [ ] I've added any new APIs to the API Reference. For example, if I
added a
method in Tune, I've added it in `doc/source/tune/api/` under the
           corresponding `.rst` file.
- [ ] I've made sure the tests are passing. Note that there might be a
few flaky tests, see the recent failures at https://flakey-tests.ray.io/
- Testing Strategy
   - [ ] Unit tests
   - [ ] Release tests
   - [ ] This PR is not tested :(

---------

Signed-off-by: cristianjd <cristian.j.derr@gmail.com>
pcmoritz pushed a commit that referenced this pull request Feb 12, 2025
This cherry picks #50292 to
release 2.42.1 so the version picker correctly respects the selected
version

## Checks

- [ ] I've signed off every commit(by using the -s flag, i.e., `git
commit -s`) in this PR.
- [ ] I've run `scripts/format.sh` to lint the changes in this PR.
- [ ] I've included any doc changes needed for
https://docs.ray.io/en/master/.
- [ ] I've added any new APIs to the API Reference. For example, if I
added a
method in Tune, I've added it in `doc/source/tune/api/` under the
           corresponding `.rst` file.
- [ ] I've made sure the tests are passing. Note that there might be a
few flaky tests, see the recent failures at https://flakey-tests.ray.io/
- Testing Strategy
   - [ ] Unit tests
   - [ ] Release tests
   - [ ] This PR is not tested :(

Signed-off-by: cristianjd <cristian.j.derr@gmail.com>
pcmoritz pushed a commit that referenced this pull request Feb 13, 2025
Cherry picks the following PRs to version 2.39.0 to fix version switcher
issues

#49892
#50292

## Checks

- [ ] I've signed off every commit(by using the -s flag, i.e., `git
commit -s`) in this PR.
- [ ] I've run `scripts/format.sh` to lint the changes in this PR.
- [ ] I've included any doc changes needed for
https://docs.ray.io/en/master/.
- [ ] I've added any new APIs to the API Reference. For example, if I
added a
method in Tune, I've added it in `doc/source/tune/api/` under the
           corresponding `.rst` file.
- [ ] I've made sure the tests are passing. Note that there might be a
few flaky tests, see the recent failures at https://flakey-tests.ray.io/
- Testing Strategy
   - [ ] Unit tests
   - [ ] Release tests
   - [ ] This PR is not tested :(

---------

Signed-off-by: cristianjd <cristian.j.derr@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
go add ONLY when ready to merge, run all tests
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants