Skip to content

Conversation

Golenspade
Copy link

Add two GitHub CLI pages:

  • gh pr checks: view and watch CI checks (--watch, --required).
  • gh pr merge: common merge strategies (--merge, --squash --delete-branch, --rebase, --auto, --admin).

All examples follow the tldr style and pass tldrl.

Validation:

@CLAassistant
Copy link

CLAassistant commented Oct 6, 2025

CLA assistant check
All committers have signed the CLA.

@github-actions github-actions bot added new command Issues requesting creation of a new page or PRs adding a new page for a command. page edit Changes to an existing page(s). review needed Prioritized PRs marked for reviews from maintainers. labels Oct 6, 2025
@Managor Managor changed the title docs(gh): add gh pr checks and gh pr merge tldr pages gh-pr-{checks, merge}`: add page Oct 6, 2025
@Managor Managor changed the title gh-pr-{checks, merge}`: add page gh-pr-{checks, merge}: add page Oct 6, 2025
@Managor Managor changed the title gh-pr-{checks, merge}: add page gh-pr-{checks, merge}: add pages Oct 6, 2025
@Managor Managor mentioned this pull request Oct 6, 2025
35 tasks
@dmmqz dmmqz changed the title gh-pr-{checks, merge}: add pages gh-pr-checks: add pages; gh-pr-merge: update page Oct 6, 2025
…example

- Remove "Part of the GitHub CLI" line from both pages
- Restore interactive merge example as first example in gh-pr-merge
- Update flags to show both short and long forms: [-m|--merge], [-sd|--squash --delete-branch], [-r|--rebase], [-s|--squash]
- Merge short options where applicable (e.g., -sd for -s -d)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>
`gh pr merge`

- Merge the specified pull request, interactively:
- Merge with a merge commit:
Copy link
Member

Choose a reason for hiding this comment

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

This could use some more explanation. I don't know but I'm assuming this is correct

Suggested change
- Merge with a merge commit:
- Merge the current branch into the specified pull request:

- Merge with a merge commit:

`gh pr merge {{pr_number}}`
`gh pr merge {{123}} {{[-m|--merge]}}`
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
`gh pr merge {{123}} {{[-m|--merge]}}`
`gh pr merge {{pr_number}} {{[-m|--merge]}}`

`gh pr merge {{123}} {{[-m|--merge]}}`

- Merge the pull request, removing the branch on both the local and the remote:
- Squash and merge, then delete the branch:
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
- Squash and merge, then delete the branch:
- Squash and merge a pull request, then delete the branch:

- Squash and merge, then delete the branch:

`gh pr merge {{[-d|--delete-branch]}}`
`gh pr merge {{123}} {{[-sd|--squash --delete-branch]}}`
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
`gh pr merge {{123}} {{[-sd|--squash --delete-branch]}}`
`gh pr merge {{pr_number}} {{[-sd|--squash --delete-branch]}}`

- Rebase and merge:

`gh pr merge --{{merge|squash|rebase}}`
`gh pr merge {{123}} {{[-r|--rebase]}}`
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
`gh pr merge {{123}} {{[-r|--rebase]}}`
`gh pr merge {{pr_number}} {{[-r|--rebase]}}`

- Enable auto-merge (squash):

`gh pr merge --{{merge|squash|rebase}} {{[-t|--subject]}} {{commit_message}}`
`gh pr merge {{123}} --auto {{[-s|--squash]}}`
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
`gh pr merge {{123}} --auto {{[-s|--squash]}}`
`gh pr merge {{pr_number}} --auto {{[-s|--squash]}}`

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
new command Issues requesting creation of a new page or PRs adding a new page for a command. page edit Changes to an existing page(s). review needed Prioritized PRs marked for reviews from maintainers.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants