Case example
There's the tag vim with the usage guidance, or tag wiki excerpt,
Vim is a free and open-source modal text editor available for most major platforms. It allows high efficiency in many text editing tasks but has a steep learning curve. To learn the basics, run ":help vimtutor".
And there's the tag viml with the tag wiki excerpt
VimL, or VimScript, is the scripting language used to program (and configure) the Vim editor.
But viml
has been remapped to vim
and degraded to a synonym. While this is okay in some ways, it seems to have the unfortunate consequence that the viml
tooltip shows the usage guidance blurb of vim
, with no mention at all of what viml
means - this is quite confusing for me as a user. Furthermore, the info and edit links in the viml
tooltip lead to the tag info for vim
, while the full tag wiki of viml
has valuable information not contained in vim
. Only via the Tags page I've been able to dig this information up.
I think this behavior is not ideal and propose two ways to improve it.
- Show the original usage guidance of
viml
in its tooltip and link to its original tag info, or - include the information about the synonym(s) in the excerpt of the main tag and merge the full tag wikis of the main tag and the synonym(s) as well.