Re: [POLL] Add command names to key bindings in Org Guide? (was: Suggestion: for each listed keybinding, also name the command)

[Ihor Radchenko]

Ihor Radchenko  writes:

> Yuval Langer  writes:
>
>> For many commands, I find it helpful to first learn their names before
>> learning their keybindings. The org-mode guide does not include
>> command names.
>>
>> I want to add command names into the org-mode guide. I have attached
>> an example of such an addition.
>
> Will it be useful?

Done.

-- 
Ihor Radchenko // yantar92,
Org mode contributor,
Learn more about Org mode at .
Support Org development at ,
or support my work at 

Re: [POLL] Add command names to key bindings in Org Guide? (was: Suggestion: for each listed keybinding, also name the command)

[Corwin Brust]

On Sat, May 6, 2023, 01:26 Adham Omran  wrote:

> >> I want to add command names into the org-mode guide. I have attached
> >> an example of such an addition.
> >
> > Will it be useful?
> >
> > Technically, adding the command name will increase the Org Guide size,
> > which is a bit against its idea of compactness.
>
> Wouldn't it just put additional information on the same line as the
> keybinding?
>

This was my thought, also.

>
> > On the other hand, new users may benefit from seeing the command names
> > alongside with the bindings, especially users of pre-packages Emacs
> > where the bindings may be shadowed by evil-mode and the likes.
> >
> > WDYT?


> I think this would result in a more coherent experience between the
> manuals as the Emacs manual and Org mode manual both provide command names
> for most of the keybindings.
>


+1

Especially, I think new spacemacs and doom users starting out with evil.el
will appreciate knowing the extended command names.

Re: [POLL] Add command names to key bindings in Org Guide? (was: Suggestion: for each listed keybinding, also name the command)

[Jens Neuhalfen]

> 
> On the other hand, new users may benefit from seeing the command names
> alongside with the bindings, especially users of pre-packages Emacs
> where the bindings may be shadowed by evil-mode and the likes.
> 
> WDYT?

I am in favor. One of my main problems in learning emacs: I started with evil 
and all documentation lacking the function names was literally a huge source of 
frustration. Also, humans are much better at remembering names than high 
entropy keystrokes. If I just remember a bit of the name, I can easily find the 
key binding in the help. The other way around is not possible. Just like a 
phone book. The numbers (key bindings) are shorter, yes. But good luck trying 
to find 555-12346 when you remember 555-12345.

BR Jens

Re: [POLL] Add command names to key bindings in Org Guide? (was: Suggestion: for each listed keybinding, also name the command)

[Adham Omran]

>> I want to add command names into the org-mode guide. I have attached
>> an example of such an addition.
>
> Will it be useful?
>
> Technically, adding the command name will increase the Org Guide size,
> which is a bit against its idea of compactness.

Wouldn't it just put additional information on the same line as the keybinding?

> On the other hand, new users may benefit from seeing the command names
> alongside with the bindings, especially users of pre-packages Emacs
> where the bindings may be shadowed by evil-mode and the likes.
>
> WDYT?

I think this would result in a more coherent experience between the manuals as 
the Emacs manual and Org mode manual both provide command names for most of the 
keybindings.

- Adham Omran