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

Mac Command key #428

Open
rgaiacs opened this Issue Sep 9, 2018 · 2 comments

Comments

Projects
None yet
3 participants
@rgaiacs
Contributor

rgaiacs commented Sep 9, 2018

http://swcarpentry.github.io/r-novice-gapminder/01-rstudio-intro/index.html says

hit <kbd>Ctrl</kbd>+<kbd>Return</kbd> in Windows or Linux or <kbd>⌘</kbd>+<kbd>Return</kbd> on OS X.

but http://carpentries.github.io/lesson-example/06-style-guide/index.html recommends to say

hit <kbd>Ctrl</kbd>+<kbd>Return</kbd> in Windows or Linux or <kbd>Command</kbd>+<kbd>Return</kbd> on OS X.

The reasons why I decided to use <kbd>Command</kbd> instead of <kbd>⌘</kbd> are (1) text to speak might better read the word instead of the symbol and (2) type the word doesn't require knowledge of how to insert special characters.

@jcoliver

This comment has been minimized.

Collaborator

jcoliver commented Sep 12, 2018

Good idea. Is there potential for confusion/conflict with non-English keyboards, though? Is there a way to keep the key name and the symbol?

@lucymchang

This comment has been minimized.

Contributor

lucymchang commented Nov 16, 2018

It seems like it's rare to find a physical Apple keyboard that does not have the word "command" or "cmd" associated with the symbol, even on international keyboards. I think both points @rgaiacs brought up are good ones. That being said, it would be quite useful to include both the symbol and key name. https://en.wikipedia.org/wiki/QWERTY has been formatted this way and appears quite clear, though this would require a change to the style guide.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment