From @OKiMaureen:

What feature or product is affected?

Improve documentation for project board keyboard shortcut

https://docs.github.com/en/free-pro-team@latest/github/getting-started-with-github/keyboard-shortcuts#project-boards

What is the new or expected behavior?

The user said:

I would suggest improving the keyboard shortcut documentation for project boards to be more clear about using enter to begin the process of moving cards.

This can be done by adding a separate description at the top that one needs to enter moving mode first.

Reason being that usually, keyboard shortcuts that are in a list like that don't depend on one another, Which is why I merely scanned the list for "move card to the top" and didn't think that any of the other entries in the list would be relevant.

How is the old or inaccurate behavior currently documented?

The Keyboard shortcuts for project boards are in a list which doesn't insinuate that the shortcuts depend on one another.

Who does this affect?

Users who make use of project board keyboard shortcuts

What is the impact to users?

Confusion.

Additional information

Example user from zendesk :

According to the docs, you'll have to first press enter to begin the process of moving a card. After that ↑ moves it up one step & control ↑ moves it to the top of the column. To finish the move press enter again.

I would suggest to improve the keyboard shortcut modal to be more clear about that though.
Such as adding a separate description at the top that one needs to enter moving mode first.
Reason being that usually, keyboard shortcuts that are in a list like that don't depend on one another. Which is why I merely scanned the list for "move card to the top" and didn't think that any of the other entries in the list would be relevant.

Hello @megbird , I have an idea to fix this issue #1034 . If we add a popup which will contain gif and gif popup related to respective shortcut key will get activated when user will hover the shortcut keys image or text . That would surely help beginners to remember the shortcut keys .I m figuring out how this idea can be implemented since I m beginner in contribution .Please help me in fixing this doc .

This is an one sample of popup

Thank you

👋 @StarTrooper08 I love the idea and the image ⚡ we are currently constrained to only fixing the article's content, not including any design or CSS improvements. If you'd like to contribute a more scoped edit to "Project boards" section of Keyboard shortcuts article, that would be a PR we could accept 😄

For each row where it's applicable, we can make the shortcut clearer by saying:

"enter, then ↑ork

and other similar edits wherever applicable in thatt section of the article. Let me know if you have any questions!

Ya surely like to contribute to Github docs . But I m new to contribution process , please guide me in the process . I will surely fix the issue #1034 .Thank you .

@megbird how can I edit the keyboard shortcut part .
Please help me since I m a beginner contributer😅.

👋 @StarTrooper08 Take a look at the contributing.md, then feel free to open a discussion if you have any additional questions 💛