📝 Documentation: Clarify how to operate the Clack prompt

[johnnyreilly]

Bug Report Checklist

• [X] I have pulled the latest main branch of the repository.
• [X] I have searched for related issues and found none that matched my issue.

Overview

As you can probably gather, I didn't work out how and ended up with everything to my chagrin!

Additional Info

n/a

[github-actions[bot]]

Uh oh! @johnnyreilly, the image you shared is missing helpful alt text. Check your issue body.

Alt text is an invisible description that helps screen readers describe images to blind or low-vision users. If you are using markdown to display images, add your alt text inside the brackets of the markdown image.

Learn more about alt text at Basic writing and formatting syntax: images on GitHub Docs.

[JoshuaKGoldberg]

Backing context: That prompt UI comes from Clack. Direct answer: You can press ↑ and ↓ on the keyboard to change the selected item, then space to select.

Was this not clear from the prompt? Do you think there should be some text to explain it?

[johnnyreilly]

Was this not clear from the prompt? Do you think there should be some text to explain it?

I can only say it wasn't clear to me. It's possible everyone else knows that this is how you do it:

You can press ↑ and ↓ on the keyboard to change the selected item, then space to select.

I'd encourage including the text above

[JoshuaKGoldberg]

👍 makes sense, I agree it's not super intuitive as is. Thanks for calling it out! Accepting PRs to add a small indication to the prompt.

[johnnyreilly]

I did try and work out how to add it just now but couldn't work it out. Can you advise where i'd tweak?

[JoshuaKGoldberg]

but couldn't work it out

err, what do you mean by this?

[johnnyreilly]

nevermind - found it

[github-actions[bot]]

:tada: This is included in version v1.51.0 :tada:

The release is available on:

• GitHub releases
• npm package (@latest dist-tag)

Cheers! 📦🚀