diff --git a/Documentation/docs/contributing/index.md b/Documentation/docs/contributing/index.md index 8665b5d18f8..de394dfcc4b 100644 --- a/Documentation/docs/contributing/index.md +++ b/Documentation/docs/contributing/index.md @@ -226,8 +226,34 @@ Push commits in your topic branch for review by the community: git review-push --force ``` -A URL will be provided in the terminal -- visit this url to review the topic -and open a pull request. +A URL will be provided in the terminal. + +(create-a-pr)= +Create a Pull Request +--------------------- + +Follow the URL provided in the terminal to open a pull request against the +upstream repository. **Open the pull request as a Draft** until the automated +tests pass. A draft PR signals that the work is still in progress and prevents +reviewers from spending time on code that is not yet ready. + +Once the CI tests pass and you are satisfied with the change, convert the draft +to *Ready for Review* and request reviewers. This notifies maintainers that the +code is ready for their attention and ensures their review time is spent +effectively. + +```{important} +**AI-agent-assisted pull requests must be opened in Draft mode.** An +agent-created PR must not be converted to *Ready for Review* until the human +author has personally verified that: + +- all automated CI tests pass, +- the implementation is correct and complete, +- the PR description accurately reflects the changes made. + +Reviewer time is a finite human resource. Do not request a review before these +conditions are met. +``` Optionally, discuss the change by opening a topic on [ITK's Discourse].