{"action":"created","issue":{"url":"https://api.github.com/repos/syl20bnr/spacemacs/issues/5669","repository_url":"https://api.github.com/repos/syl20bnr/spacemacs","labels_url":"https://api.github.com/repos/syl20bnr/spacemacs/issues/5669/labels{/name}","comments_url":"https://api.github.com/repos/syl20bnr/spacemacs/issues/5669/comments","events_url":"https://api.github.com/repos/syl20bnr/spacemacs/issues/5669/events","html_url":"https://github.com/syl20bnr/spacemacs/issues/5669","id":145586057,"number":5669,"title":"Consider enabling menu-bar by default for the benefit of new users","user":{"login":"gilch","id":3346292,"avatar_url":"https://avatars.githubusercontent.com/u/3346292?v=3","gravatar_id":"","url":"https://api.github.com/users/gilch","html_url":"https://github.com/gilch","followers_url":"https://api.github.com/users/gilch/followers","following_url":"https://api.github.com/users/gilch/following{/other_user}","gists_url":"https://api.github.com/users/gilch/gists{/gist_id}","starred_url":"https://api.github.com/users/gilch/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/gilch/subscriptions","organizations_url":"https://api.github.com/users/gilch/orgs","repos_url":"https://api.github.com/users/gilch/repos","events_url":"https://api.github.com/users/gilch/events{/privacy}","received_events_url":"https://api.github.com/users/gilch/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/syl20bnr/spacemacs/labels/-%20Mailling%20list%20-","name":"- Mailling list -","color":"fef2c0"}],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":5,"created_at":"2016-04-04T05:08:41Z","updated_at":"2016-04-05T10:57:11Z","closed_at":null,"body":"Discoverability is one of the pillars of Spacemacs. The which-key package included by default helps a great deal on this point. However, it does not reveal the bindings for single-character commands, like `f10` to use the menus. While this is a fairly standard key to invoke menus, it is a somewhat obscure one. (Most Windows users, for example, expect Alt to reveal a hidden menu, and when that doesn't work, won't think to try `f10`.)\r\n\r\nFor many commands a graphical menu is easier to search through than which-key, since backtracking requires a restart of the command, but the graphical menu doesn't. Some things available through the menus don't even have a keybinding. The menus also change with the modes, aiding discoverability of new features.\r\n\r\nEmacs updates the menu text with the currently valid keybindings, including the SPC bindings, when applicable. This helps new the user to learn those bindings more quickly, since they can more easily find commands they've used from the menus before.\r\n\r\nThe buffer menu can help a vim user escape a non-evilified buffer (like Custom, see #5668), it also helps those unfamiliar with emacs understand how buffers work, since they're not so invisible given the buffer menu.\r\n\r\nWe would, of course, like new users to learn to use the keyboard shortcuts instead of relying on the mouse, but they have to discover them first. When a good keyboard-based alternative to a particular menu or menu item exists (like `SPC b b` for the `buffer` menu), consider appending a note of that to the relevant menu tooltip, and of course enable tooltips by default as well to make this possible.\r\n"},"comment":{"url":"https://api.github.com/repos/syl20bnr/spacemacs/issues/comments/205755481","html_url":"https://github.com/syl20bnr/spacemacs/issues/5669#issuecomment-205755481","issue_url":"https://api.github.com/repos/syl20bnr/spacemacs/issues/5669","id":205755481,"user":{"login":"nixmaniack","id":542810,"avatar_url":"https://avatars.githubusercontent.com/u/542810?v=3","gravatar_id":"","url":"https://api.github.com/users/nixmaniack","html_url":"https://github.com/nixmaniack","followers_url":"https://api.github.com/users/nixmaniack/followers","following_url":"https://api.github.com/users/nixmaniack/following{/other_user}","gists_url":"https://api.github.com/users/nixmaniack/gists{/gist_id}","starred_url":"https://api.github.com/users/nixmaniack/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/nixmaniack/subscriptions","organizations_url":"https://api.github.com/users/nixmaniack/orgs","repos_url":"https://api.github.com/users/nixmaniack/repos","events_url":"https://api.github.com/users/nixmaniack/events{/privacy}","received_events_url":"https://api.github.com/users/nixmaniack/received_events","type":"User","site_admin":false},"created_at":"2016-04-05T10:57:11Z","updated_at":"2016-04-05T10:57:11Z","body":"> However, it does not reveal the bindings for single-character commands, like f10 to use the menus.\r\n\r\n`SPC h k` shows top level keybindings using `which-key` which indeed shows `f10` and others(you might have to page through). Is that what you're looking for? "}}