From b9439afa7819aa84960e87a55fe354dcd2044bcd Mon Sep 17 00:00:00 2001 From: Josh Johanning Date: Tue, 24 Mar 2026 09:43:12 -0500 Subject: [PATCH 1/3] docs: clarify that --add-reviewer can re-request reviews The --add-reviewer flag on pr edit already supports re-requesting reviews from reviewers who have already submitted their review, but this wasn't documented in the help text. Ref #12489 Ref #2053 --- pkg/cmd/pr/edit/edit.go | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pkg/cmd/pr/edit/edit.go b/pkg/cmd/pr/edit/edit.go index 157fc8f8a7b..1b40a16f734 100644 --- a/pkg/cmd/pr/edit/edit.go +++ b/pkg/cmd/pr/edit/edit.go @@ -190,7 +190,7 @@ func NewCmdEdit(f *cmdutil.Factory, runF func(*EditOptions) error) *cobra.Comman cmd.Flags().StringVarP(&opts.Editable.Body.Value, "body", "b", "", "Set the new body.") cmd.Flags().StringVarP(&bodyFile, "body-file", "F", "", "Read body text from `file` (use \"-\" to read from standard input)") cmd.Flags().StringVarP(&opts.Editable.Base.Value, "base", "B", "", "Change the base `branch` for this pull request") - cmd.Flags().StringSliceVar(&opts.Editable.Reviewers.Add, "add-reviewer", nil, "Add reviewers by their `login`. Use \"@copilot\" to request review from Copilot.") + cmd.Flags().StringSliceVar(&opts.Editable.Reviewers.Add, "add-reviewer", nil, "Add reviewers by their `login`. Use \"@copilot\" to request review from Copilot. Can also be used to re-request review from reviewers who have already submitted their review.") cmd.Flags().StringSliceVar(&opts.Editable.Reviewers.Remove, "remove-reviewer", nil, "Remove reviewers by their `login`. Use \"@copilot\" to remove review request from Copilot.") cmd.Flags().StringSliceVar(&opts.Editable.Assignees.Add, "add-assignee", nil, "Add assigned users by their `login`. Use \"@me\" to assign yourself, or \"@copilot\" to assign Copilot.") cmd.Flags().StringSliceVar(&opts.Editable.Assignees.Remove, "remove-assignee", nil, "Remove assigned users by their `login`. Use \"@me\" to unassign yourself, or \"@copilot\" to unassign Copilot.") From 84050fbbad855b7f94b0939fea79302d46980efd Mon Sep 17 00:00:00 2001 From: Kynan Ware <47394200+BagToad@users.noreply.github.com> Date: Tue, 24 Mar 2026 09:20:08 -0600 Subject: [PATCH 2/3] docs(pr edit): improve command examples with grouped sections Add comment headers to group examples by concern (title/body, labels, reviewers, assignees, projects/milestones), matching the style used by other commands like pr review and repo create. Also adds examples for --body-file and re-requesting review via --add-reviewer. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- pkg/cmd/pr/edit/edit.go | 21 ++++++++++++++++++++- 1 file changed, 20 insertions(+), 1 deletion(-) diff --git a/pkg/cmd/pr/edit/edit.go b/pkg/cmd/pr/edit/edit.go index 1b40a16f734..08bcd86023f 100644 --- a/pkg/cmd/pr/edit/edit.go +++ b/pkg/cmd/pr/edit/edit.go @@ -74,12 +74,31 @@ func NewCmdEdit(f *cmdutil.Factory, runF func(*EditOptions) error) *cobra.Comman - %[1]s@copilot%[1]s: request or remove review from Copilot (not supported on GitHub Enterprise Server) `, "`"), Example: heredoc.Doc(` + # Edit the title and body of a pull request $ gh pr edit 23 --title "I found a bug" --body "Nothing works" + + # Use a file as the body + $ gh pr edit 23 --body-file body.txt + + # Manage labels $ gh pr edit 23 --add-label "bug,help wanted" --remove-label "core" - $ gh pr edit 23 --add-reviewer monalisa,hubot --remove-reviewer myorg/team-name + + # Manage reviewers + $ gh pr edit 23 --add-reviewer monalisa,hubot --remove-reviewer myorg/team-name + + # Re-request review + $ gh pr edit 23 --add-reviewer monalisa + + # Request a review from GitHub Copilot $ gh pr edit 23 --add-reviewer "@copilot" + + # Manage assignees $ gh pr edit 23 --add-assignee "@me" --remove-assignee monalisa,hubot + + # Assign GitHub Copilot $ gh pr edit 23 --add-assignee "@copilot" + + # Manage projects and milestones $ gh pr edit 23 --add-project "Roadmap" --remove-project v1,v2 $ gh pr edit 23 --milestone "Version 1" $ gh pr edit 23 --remove-milestone From 761229f05754e9c88d36e9ab4df9e845edfa28b0 Mon Sep 17 00:00:00 2001 From: Josh Johanning Date: Tue, 24 Mar 2026 10:37:20 -0500 Subject: [PATCH 3/3] docs: simplify flag text applying @BagToad's suggestion to simplify the wording to avoid line wrapping Co-authored-by: Kynan Ware <47394200+BagToad@users.noreply.github.com> --- pkg/cmd/pr/edit/edit.go | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pkg/cmd/pr/edit/edit.go b/pkg/cmd/pr/edit/edit.go index 08bcd86023f..62811fe0c95 100644 --- a/pkg/cmd/pr/edit/edit.go +++ b/pkg/cmd/pr/edit/edit.go @@ -209,7 +209,7 @@ func NewCmdEdit(f *cmdutil.Factory, runF func(*EditOptions) error) *cobra.Comman cmd.Flags().StringVarP(&opts.Editable.Body.Value, "body", "b", "", "Set the new body.") cmd.Flags().StringVarP(&bodyFile, "body-file", "F", "", "Read body text from `file` (use \"-\" to read from standard input)") cmd.Flags().StringVarP(&opts.Editable.Base.Value, "base", "B", "", "Change the base `branch` for this pull request") - cmd.Flags().StringSliceVar(&opts.Editable.Reviewers.Add, "add-reviewer", nil, "Add reviewers by their `login`. Use \"@copilot\" to request review from Copilot. Can also be used to re-request review from reviewers who have already submitted their review.") + cmd.Flags().StringSliceVar(&opts.Editable.Reviewers.Add, "add-reviewer", nil, "Add or re-request reviewers by their `login`. Use \"@copilot\" to request review from Copilot.") cmd.Flags().StringSliceVar(&opts.Editable.Reviewers.Remove, "remove-reviewer", nil, "Remove reviewers by their `login`. Use \"@copilot\" to remove review request from Copilot.") cmd.Flags().StringSliceVar(&opts.Editable.Assignees.Add, "add-assignee", nil, "Add assigned users by their `login`. Use \"@me\" to assign yourself, or \"@copilot\" to assign Copilot.") cmd.Flags().StringSliceVar(&opts.Editable.Assignees.Remove, "remove-assignee", nil, "Remove assigned users by their `login`. Use \"@me\" to unassign yourself, or \"@copilot\" to unassign Copilot.")