Add the ability to switch a pull request to a draft

[khatchad]

Add the ability to switch an existing pull request to a draft. Currently, there doesn't seem to be such an option. I don't see it in any of the pr commands nor does it come up with gh pr edit. There seems to be other similar commands like gh pr lock and gh pr unlock. There is also gh pr ready. Maybe we need gh pr unready?

[williammartin]

I think you're looking for gh pr ready --undo. I don't know the historical reasons for this being a flag on pr ready but it was outlined here: #2271 (comment)

[khatchad]

The scenario I am thinking of is where a PR was never a draft to begin with. This, "undo" would seem a bit counterintuitive. The edit flag looks good, but what I was thinking of was something along the lines of lock and unlock (i.e., ready and unready).

[williammartin]

This, "undo" would seem a bit counterintuitive.

Yeh, that's why I'm not sure why a flag was chosen originally, but it is the behaviour you're looking for. Behind the scenes it maps to convertPullRequestToDraft graphql mutation, so it's not really anything to do with undoing at all.

The edit flag looks good

This doesn't exist, it was a design proposal that wasn't implemented in #5995

but what I was thinking of was something along the lines of lock and unlock (i.e., ready and unready).

Yeh this has been discussed before and rejected here: #7053

That said, no one from the team that made that decision is still working on the project and I'm sympathetic to the fact that you're not undoing anything and it's also kind of hard to discover. Still, I'm not sure it's worth us addressing until we do a v3 as it's also confusing to have two ways supported ways of achieving the same thing.

In the meantime I'd suggest you gh alias set unready "gh pr ready --undo".