-
Notifications
You must be signed in to change notification settings - Fork 4k
Corrected hotkey for code comments on Mac #3901
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Conversation
CLA assistant check
All committers have signed the CLA.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Pull Request Overview
This PR updates the Mac hotkey documentation for code commenting in a JavaScript tutorial article, changing from a generic substitution instruction to specific key combinations.
Key Changes:
- Replaces generic Mac modifier key substitution guidance with explicit hotkey combinations
- Specifies
Cmd+/for single-line comments on Mac - Adds
Option+Shift+Aas the VS Code multiline comment hotkey for Mac
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Copilot
AI
Nov 12, 2025
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The multiline comment hotkey documentation has inconsistencies:
-
Editor specificity: Adding "(on VS Code)" only for multiline comments is inconsistent since the earlier part of the sentence refers to "most editors" without specifying which one. This creates confusion about whether the Mac instructions apply generally or only to VS Code.
-
Key order: The standard convention is to list modifier keys in order (Shift before Option), so it should be
key:Shift+Option+Arather thankey:Option+Shift+A. -
Incomplete information: If you're going to specify VS Code for multiline comments, you should clarify what applies to other editors. Alternatively, provide the general Mac equivalent like the original approach, or note that multiline comment hotkeys vary by editor.
Consider revising to either:
- Keep it general: "For Mac, try
key:Cmd+/for single-line comments andkey:Cmd+Option+/orkey:Shift+Option+Afor multiline comments (varies by editor)." - Or be consistent about editor-specificity throughout the sentence.
smith558
commented
Nov 12, 2025
@Lk-ux please check some of the comments
No description provided.