Yeah, Craig and I decided to go with the convention that the thing in brackets in a tooltip is the keyboard shortcut and it doesn't need any introduction.
We were previously very inconsistent in this, sometimes using "Save (⌘S)", sometimes using "Save (type '⌘' + 'S')", and so on. We looked at other applications, and couldn't see anywhere where they use the "type …" conventions: Eclipse, IntelliJ, Mac apps, MS Office, and so on.
We'll probably remain inconsistent in some areas until we clean all of this up. The new way works like this:
- All platforms: multiple keys are separated by commas. Example: "Recently Viewed (g, r)"
- All platforms: shortcuts without modifiers use lowercase latters, with modifiers use uppercase. Example: "Create (c)", "Copy (⌘C)".
- Mac: modifier keys immediately followed by letters. Example: "Save (⌘S)"
- Windows & Linux: modifier keys separated by pluses. Example: "Save (Ctrl+S)"
Make sense?
Hi Esther,
Closing this out since it doesn't seem to be a problem any more.