[doc][2/N] Adding doc strings and doc pages for public methods in trainer and utils#1397
Merged
eric-haibin-lin merged 40 commits intoverl-project:mainfrom May 27, 2025
Merged
Conversation
Signed-off-by: Hongpeng Guo <hg5@illinois.edu>
Signed-off-by: Hongpeng Guo <hg5@illinois.edu>
Signed-off-by: Hongpeng Guo <hg5@illinois.edu>
Signed-off-by: Hongpeng Guo <hg5@illinois.edu>
Signed-off-by: Hongpeng Guo <hg5@illinois.edu>
6 tasks
Signed-off-by: Hongpeng Guo <hg5@illinois.edu>
Signed-off-by: Hongpeng Guo <hg5@illinois.edu>
Signed-off-by: Hongpeng Guo <hg5@illinois.edu>
Signed-off-by: Hongpeng Guo <hg5@illinois.edu>
Signed-off-by: Hongpeng Guo <hg5@illinois.edu>
Signed-off-by: Hongpeng Guo <hg5@illinois.edu>
Signed-off-by: Hongpeng Guo <hg5@illinois.edu>
Signed-off-by: Hongpeng Guo <hg5@illinois.edu>
Signed-off-by: Hongpeng Guo <hg5@illinois.edu>
Signed-off-by: Hongpeng Guo <hg5@illinois.edu>
Signed-off-by: Hongpeng Guo <hg5@illinois.edu>
Signed-off-by: Hongpeng Guo <hg5@illinois.edu>
Signed-off-by: Hongpeng Guo <hg5@illinois.edu>
Signed-off-by: Hongpeng Guo <hg5@illinois.edu>
Signed-off-by: Hongpeng Guo <hg5@illinois.edu>
Signed-off-by: Hongpeng Guo <hg5@illinois.edu>
Signed-off-by: Hongpeng Guo <hg5@illinois.edu>
Signed-off-by: Hongpeng Guo <hg5@illinois.edu>
Signed-off-by: Hongpeng Guo <hg5@illinois.edu>
Collaborator
Author
|
@eric-haibin-lin this PR is good for another round of review. |
trainer and utilstrainer and utils
eric-haibin-lin
approved these changes
May 27, 2025
Collaborator
eric-haibin-lin
left a comment
There was a problem hiding this comment.
please add _default_compute_score back for backward compatibility purpose, and add deprecation warning to it
6 tasks
vermouth1992
pushed a commit
that referenced
this pull request
May 28, 2025
… utils test (#1729) ### Checklist Before Starting - [x] Search for similar PR(s). ### What does this PR do? Handle comments after #1397 being merged: 1. Add back `_default_compute_score` API and mark it as deprecated; 2. Fix a broken ci test `ray_utils_test` on `parallel_put`; ### Checklist Before Submitting - [x] Read the [Contribute Guide](https://github.com/volcengine/verl?tab=readme-ov-file#contribution-guide). - [x] Apply [pre-commit checks](https://github.com/volcengine/verl?tab=readme-ov-file#code-linting-and-formatting). - [ ] Add `[BREAKING]` to the PR title if it breaks any API. - [ ] Update the documentation about your changes in the [docs](https://github.com/volcengine/verl/tree/main/docs). - [ ] Add CI test(s) if necessary. --------- Signed-off-by: Hongpeng Guo <hg5@illinois.edu>
ETOgaosion
pushed a commit
to Jianbing-D/verl
that referenced
this pull request
Jun 8, 2025
…in `trainer` and `utils` (verl-project#1397) ### Checklist Before Starting - [x] Search for similar PR(s). ### What does this PR do? * This PR adds doc string for the public methods inside `trainer` and `utils` module, so that these methods can be reused and referenced better. * Two new doc page `PPO Trainer Interface` and `Utilities` were also provided under the API Reference section. * Renamed one function `verl.utils._default_compute_score` to `verl.utils.default_compute_score`, as it was an external function used by other modules, i.e., trainer and recipe; <img width="1093" alt="Screenshot 2025-05-26 at 9 20 31 PM" src="https://github.com/user-attachments/assets/e361e6bd-a33b-426b-85b4-9fe93ab1e398" /> ### TODO This is the second of a series of PRs to improve and stabilize the docs and API. Stacked on top of verl-project#1396 TODO includes adding more useful utility functions to the doc with improved doc strings. ### Additional Info. - **Issue Number**: Fixes issue # or discussion # if any. - **Training**: [Note which backend this PR will affect: FSDP, Megatron, both, or none] - **Inference**: [Note which backend this PR will affect: vLLM, SGLang, both, or none] ### Checklist Before Submitting - [x] Read the [Contribute Guide](https://github.com/volcengine/verl?tab=readme-ov-file#contribution-guide). - [x] Apply [pre-commit checks](https://github.com/volcengine/verl?tab=readme-ov-file#code-linting-and-formatting). - [ ] Add `[BREAKING]` to the PR title if it breaks any API. - [x] Update the documentation about your changes in the [docs](https://github.com/volcengine/verl/tree/main/docs). - [x] Add CI test(s) if neccessary. --------- Signed-off-by: Hongpeng Guo <hg5@illinois.edu> Co-authored-by: H <linhaibin.eric@gmail.com>
ETOgaosion
pushed a commit
to Jianbing-D/verl
that referenced
this pull request
Jun 8, 2025
… utils test (verl-project#1729) ### Checklist Before Starting - [x] Search for similar PR(s). ### What does this PR do? Handle comments after verl-project#1397 being merged: 1. Add back `_default_compute_score` API and mark it as deprecated; 2. Fix a broken ci test `ray_utils_test` on `parallel_put`; ### Checklist Before Submitting - [x] Read the [Contribute Guide](https://github.com/volcengine/verl?tab=readme-ov-file#contribution-guide). - [x] Apply [pre-commit checks](https://github.com/volcengine/verl?tab=readme-ov-file#code-linting-and-formatting). - [ ] Add `[BREAKING]` to the PR title if it breaks any API. - [ ] Update the documentation about your changes in the [docs](https://github.com/volcengine/verl/tree/main/docs). - [ ] Add CI test(s) if necessary. --------- Signed-off-by: Hongpeng Guo <hg5@illinois.edu>
wwwjn
pushed a commit
to wwwjn/verl
that referenced
this pull request
Jun 10, 2025
…in `trainer` and `utils` (verl-project#1397) ### Checklist Before Starting - [x] Search for similar PR(s). ### What does this PR do? * This PR adds doc string for the public methods inside `trainer` and `utils` module, so that these methods can be reused and referenced better. * Two new doc page `PPO Trainer Interface` and `Utilities` were also provided under the API Reference section. * Renamed one function `verl.utils._default_compute_score` to `verl.utils.default_compute_score`, as it was an external function used by other modules, i.e., trainer and recipe; <img width="1093" alt="Screenshot 2025-05-26 at 9 20 31 PM" src="https://github.com/user-attachments/assets/e361e6bd-a33b-426b-85b4-9fe93ab1e398" /> ### TODO This is the second of a series of PRs to improve and stabilize the docs and API. Stacked on top of verl-project#1396 TODO includes adding more useful utility functions to the doc with improved doc strings. ### Additional Info. - **Issue Number**: Fixes issue # or discussion # if any. - **Training**: [Note which backend this PR will affect: FSDP, Megatron, both, or none] - **Inference**: [Note which backend this PR will affect: vLLM, SGLang, both, or none] ### Checklist Before Submitting - [x] Read the [Contribute Guide](https://github.com/volcengine/verl?tab=readme-ov-file#contribution-guide). - [x] Apply [pre-commit checks](https://github.com/volcengine/verl?tab=readme-ov-file#code-linting-and-formatting). - [ ] Add `[BREAKING]` to the PR title if it breaks any API. - [x] Update the documentation about your changes in the [docs](https://github.com/volcengine/verl/tree/main/docs). - [x] Add CI test(s) if neccessary. --------- Signed-off-by: Hongpeng Guo <hg5@illinois.edu> Co-authored-by: H <linhaibin.eric@gmail.com>
wwwjn
pushed a commit
to wwwjn/verl
that referenced
this pull request
Jun 10, 2025
… utils test (verl-project#1729) ### Checklist Before Starting - [x] Search for similar PR(s). ### What does this PR do? Handle comments after verl-project#1397 being merged: 1. Add back `_default_compute_score` API and mark it as deprecated; 2. Fix a broken ci test `ray_utils_test` on `parallel_put`; ### Checklist Before Submitting - [x] Read the [Contribute Guide](https://github.com/volcengine/verl?tab=readme-ov-file#contribution-guide). - [x] Apply [pre-commit checks](https://github.com/volcengine/verl?tab=readme-ov-file#code-linting-and-formatting). - [ ] Add `[BREAKING]` to the PR title if it breaks any API. - [ ] Update the documentation about your changes in the [docs](https://github.com/volcengine/verl/tree/main/docs). - [ ] Add CI test(s) if necessary. --------- Signed-off-by: Hongpeng Guo <hg5@illinois.edu>
chenjiaoAngel
added a commit
to chenjiaoAngel/verl
that referenced
this pull request
Nov 14, 2025
…methods in `single_controller` (verl-project#1396) ### Checklist Before Starting - [x] Search for similar PR(s). ### What does this PR do? This PR adds doc string for the public methods inside `single_controller` module, so that these methods can be reused and referenced better. A new doc page `Single Controller Interface` was also added under the API Reference section.  ### TODO: This is the first of a series of PRs to improve and stabilize the docs and API. TODOs include: * `verl/trainer` docs * `verl/utils` docs * Generally refine doc string of the whole repo Next PR to review is verl-project#1397 ### Checklist Before Submitting - [x] Read the [Contribute Guide](https://github.com/volcengine/verl?tab=readme-ov-file#contribution-guide). - [x] Apply [pre-commit checks](https://github.com/volcengine/verl?tab=readme-ov-file#code-linting-and-formatting). - [ ] Add `[BREAKING]` to the PR title if it breaks any API. - [x] Update the documentation about your changes in the [docs](https://github.com/volcengine/verl/tree/main/docs). - [ ] Add CI test(s) if neccessary. --------- Signed-off-by: Hongpeng Guo <hg5@illinois.edu>
chenjiaoAngel
added a commit
to chenjiaoAngel/verl
that referenced
this pull request
Nov 14, 2025
…in `trainer` and `utils` (verl-project#1397) ### Checklist Before Starting - [x] Search for similar PR(s). ### What does this PR do? * This PR adds doc string for the public methods inside `trainer` and `utils` module, so that these methods can be reused and referenced better. * Two new doc page `PPO Trainer Interface` and `Utilities` were also provided under the API Reference section. * Renamed one function `verl.utils._default_compute_score` to `verl.utils.default_compute_score`, as it was an external function used by other modules, i.e., trainer and recipe; <img width="1093" alt="Screenshot 2025-05-26 at 9 20 31 PM" src="https://github.com/user-attachments/assets/e361e6bd-a33b-426b-85b4-9fe93ab1e398" /> ### TODO This is the second of a series of PRs to improve and stabilize the docs and API. Stacked on top of verl-project#1396 TODO includes adding more useful utility functions to the doc with improved doc strings. ### Additional Info. - **Issue Number**: Fixes issue # or discussion # if any. - **Training**: [Note which backend this PR will affect: FSDP, Megatron, both, or none] - **Inference**: [Note which backend this PR will affect: vLLM, SGLang, both, or none] ### Checklist Before Submitting - [x] Read the [Contribute Guide](https://github.com/volcengine/verl?tab=readme-ov-file#contribution-guide). - [x] Apply [pre-commit checks](https://github.com/volcengine/verl?tab=readme-ov-file#code-linting-and-formatting). - [ ] Add `[BREAKING]` to the PR title if it breaks any API. - [x] Update the documentation about your changes in the [docs](https://github.com/volcengine/verl/tree/main/docs). - [x] Add CI test(s) if neccessary. --------- Signed-off-by: Hongpeng Guo <hg5@illinois.edu> Co-authored-by: H <linhaibin.eric@gmail.com>
chenjiaoAngel
added a commit
to chenjiaoAngel/verl
that referenced
this pull request
Nov 14, 2025
… utils test (verl-project#1729) ### Checklist Before Starting - [x] Search for similar PR(s). ### What does this PR do? Handle comments after verl-project#1397 being merged: 1. Add back `_default_compute_score` API and mark it as deprecated; 2. Fix a broken ci test `ray_utils_test` on `parallel_put`; ### Checklist Before Submitting - [x] Read the [Contribute Guide](https://github.com/volcengine/verl?tab=readme-ov-file#contribution-guide). - [x] Apply [pre-commit checks](https://github.com/volcengine/verl?tab=readme-ov-file#code-linting-and-formatting). - [ ] Add `[BREAKING]` to the PR title if it breaks any API. - [ ] Update the documentation about your changes in the [docs](https://github.com/volcengine/verl/tree/main/docs). - [ ] Add CI test(s) if necessary. --------- Signed-off-by: Hongpeng Guo <hg5@illinois.edu>
TimurTaepov
pushed a commit
to giorgossideris/verl
that referenced
this pull request
Dec 20, 2025
…methods in `single_controller` (verl-project#1396) ### Checklist Before Starting - [x] Search for similar PR(s). ### What does this PR do? This PR adds doc string for the public methods inside `single_controller` module, so that these methods can be reused and referenced better. A new doc page `Single Controller Interface` was also added under the API Reference section.  ### TODO: This is the first of a series of PRs to improve and stabilize the docs and API. TODOs include: * `verl/trainer` docs * `verl/utils` docs * Generally refine doc string of the whole repo Next PR to review is verl-project#1397 ### Checklist Before Submitting - [x] Read the [Contribute Guide](https://github.com/volcengine/verl?tab=readme-ov-file#contribution-guide). - [x] Apply [pre-commit checks](https://github.com/volcengine/verl?tab=readme-ov-file#code-linting-and-formatting). - [ ] Add `[BREAKING]` to the PR title if it breaks any API. - [x] Update the documentation about your changes in the [docs](https://github.com/volcengine/verl/tree/main/docs). - [ ] Add CI test(s) if neccessary. --------- Signed-off-by: Hongpeng Guo <hg5@illinois.edu>
TimurTaepov
pushed a commit
to giorgossideris/verl
that referenced
this pull request
Dec 20, 2025
…in `trainer` and `utils` (verl-project#1397) ### Checklist Before Starting - [x] Search for similar PR(s). ### What does this PR do? * This PR adds doc string for the public methods inside `trainer` and `utils` module, so that these methods can be reused and referenced better. * Two new doc page `PPO Trainer Interface` and `Utilities` were also provided under the API Reference section. * Renamed one function `verl.utils._default_compute_score` to `verl.utils.default_compute_score`, as it was an external function used by other modules, i.e., trainer and recipe; <img width="1093" alt="Screenshot 2025-05-26 at 9 20 31 PM" src="https://github.com/user-attachments/assets/e361e6bd-a33b-426b-85b4-9fe93ab1e398" /> ### TODO This is the second of a series of PRs to improve and stabilize the docs and API. Stacked on top of verl-project#1396 TODO includes adding more useful utility functions to the doc with improved doc strings. ### Additional Info. - **Issue Number**: Fixes issue # or discussion # if any. - **Training**: [Note which backend this PR will affect: FSDP, Megatron, both, or none] - **Inference**: [Note which backend this PR will affect: vLLM, SGLang, both, or none] ### Checklist Before Submitting - [x] Read the [Contribute Guide](https://github.com/volcengine/verl?tab=readme-ov-file#contribution-guide). - [x] Apply [pre-commit checks](https://github.com/volcengine/verl?tab=readme-ov-file#code-linting-and-formatting). - [ ] Add `[BREAKING]` to the PR title if it breaks any API. - [x] Update the documentation about your changes in the [docs](https://github.com/volcengine/verl/tree/main/docs). - [x] Add CI test(s) if neccessary. --------- Signed-off-by: Hongpeng Guo <hg5@illinois.edu> Co-authored-by: H <linhaibin.eric@gmail.com>
TimurTaepov
pushed a commit
to giorgossideris/verl
that referenced
this pull request
Dec 20, 2025
… utils test (verl-project#1729) ### Checklist Before Starting - [x] Search for similar PR(s). ### What does this PR do? Handle comments after verl-project#1397 being merged: 1. Add back `_default_compute_score` API and mark it as deprecated; 2. Fix a broken ci test `ray_utils_test` on `parallel_put`; ### Checklist Before Submitting - [x] Read the [Contribute Guide](https://github.com/volcengine/verl?tab=readme-ov-file#contribution-guide). - [x] Apply [pre-commit checks](https://github.com/volcengine/verl?tab=readme-ov-file#code-linting-and-formatting). - [ ] Add `[BREAKING]` to the PR title if it breaks any API. - [ ] Update the documentation about your changes in the [docs](https://github.com/volcengine/verl/tree/main/docs). - [ ] Add CI test(s) if necessary. --------- Signed-off-by: Hongpeng Guo <hg5@illinois.edu>
vyomakesh0728
added a commit
to vyomakesh0728/verl
that referenced
this pull request
Jan 22, 2026
…methods in `single_controller` (verl-project#1396) ### Checklist Before Starting - [x] Search for similar PR(s). ### What does this PR do? This PR adds doc string for the public methods inside `single_controller` module, so that these methods can be reused and referenced better. A new doc page `Single Controller Interface` was also added under the API Reference section.  ### TODO: This is the first of a series of PRs to improve and stabilize the docs and API. TODOs include: * `verl/trainer` docs * `verl/utils` docs * Generally refine doc string of the whole repo Next PR to review is verl-project#1397 ### Checklist Before Submitting - [x] Read the [Contribute Guide](https://github.com/volcengine/verl?tab=readme-ov-file#contribution-guide). - [x] Apply [pre-commit checks](https://github.com/volcengine/verl?tab=readme-ov-file#code-linting-and-formatting). - [ ] Add `[BREAKING]` to the PR title if it breaks any API. - [x] Update the documentation about your changes in the [docs](https://github.com/volcengine/verl/tree/main/docs). - [ ] Add CI test(s) if neccessary. --------- Signed-off-by: Hongpeng Guo <hg5@illinois.edu>
vyomakesh0728
added a commit
to vyomakesh0728/verl
that referenced
this pull request
Jan 22, 2026
…in `trainer` and `utils` (verl-project#1397) ### Checklist Before Starting - [x] Search for similar PR(s). ### What does this PR do? * This PR adds doc string for the public methods inside `trainer` and `utils` module, so that these methods can be reused and referenced better. * Two new doc page `PPO Trainer Interface` and `Utilities` were also provided under the API Reference section. * Renamed one function `verl.utils._default_compute_score` to `verl.utils.default_compute_score`, as it was an external function used by other modules, i.e., trainer and recipe; <img width="1093" alt="Screenshot 2025-05-26 at 9 20 31 PM" src="https://github.com/user-attachments/assets/e361e6bd-a33b-426b-85b4-9fe93ab1e398" /> ### TODO This is the second of a series of PRs to improve and stabilize the docs and API. Stacked on top of verl-project#1396 TODO includes adding more useful utility functions to the doc with improved doc strings. ### Additional Info. - **Issue Number**: Fixes issue # or discussion # if any. - **Training**: [Note which backend this PR will affect: FSDP, Megatron, both, or none] - **Inference**: [Note which backend this PR will affect: vLLM, SGLang, both, or none] ### Checklist Before Submitting - [x] Read the [Contribute Guide](https://github.com/volcengine/verl?tab=readme-ov-file#contribution-guide). - [x] Apply [pre-commit checks](https://github.com/volcengine/verl?tab=readme-ov-file#code-linting-and-formatting). - [ ] Add `[BREAKING]` to the PR title if it breaks any API. - [x] Update the documentation about your changes in the [docs](https://github.com/volcengine/verl/tree/main/docs). - [x] Add CI test(s) if neccessary. --------- Signed-off-by: Hongpeng Guo <hg5@illinois.edu> Co-authored-by: H <linhaibin.eric@gmail.com>
vyomakesh0728
added a commit
to vyomakesh0728/verl
that referenced
this pull request
Jan 22, 2026
… utils test (verl-project#1729) ### Checklist Before Starting - [x] Search for similar PR(s). ### What does this PR do? Handle comments after verl-project#1397 being merged: 1. Add back `_default_compute_score` API and mark it as deprecated; 2. Fix a broken ci test `ray_utils_test` on `parallel_put`; ### Checklist Before Submitting - [x] Read the [Contribute Guide](https://github.com/volcengine/verl?tab=readme-ov-file#contribution-guide). - [x] Apply [pre-commit checks](https://github.com/volcengine/verl?tab=readme-ov-file#code-linting-and-formatting). - [ ] Add `[BREAKING]` to the PR title if it breaks any API. - [ ] Update the documentation about your changes in the [docs](https://github.com/volcengine/verl/tree/main/docs). - [ ] Add CI test(s) if necessary. --------- Signed-off-by: Hongpeng Guo <hg5@illinois.edu>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Checklist Before Starting
What does this PR do?
trainerandutilsmodule, so that these methods can be reused and referenced better.PPO Trainer InterfaceandUtilitieswere also provided under the API Reference section.verl.utils._default_compute_scoretoverl.utils.default_compute_score, as it was an external function used by other modules, i.e., trainer and recipe;TODO
This is the second of a series of PRs to improve and stabilize the docs and API. Stacked on top of #1396
TODO includes adding more useful utility functions to the doc with improved doc strings.
Additional Info.
Checklist Before Submitting
[BREAKING]to the PR title if it breaks any API.