Previously, you could only create a draft pull request when opening a new pull request. Now you can convert an existing pull request into a draft at any time.
Here are a few scenarios where this feature enhancement is useful:
- if a pull request was opened in a non-draft state by mistake.
- when a pull request is reviewed and needs additional work; converting the pull request to a draft communicates the pull request is being updated.
- when a pull request is reviewed and approved but the author wants to block merge for other reasons.
Any user with write access to the repository can convert a pull request to a draft pull request.
To convert a pull request to a draft, look for the “Convert to draft” link in the Reviewers section on the pull request’s Conversations tab. Clicking the link displays a modal asking you to confirm the change.
Note, if you convert a pull request to a draft, users who are subscribed to the pull request will remain subscribed.