nvim-tree / nvim-tree/nvim-tree.lua
Mappings/functionality discoverability discussion
Nobody has claimed this yet.
- Dominant language
- Lua
- Stars
- 8.6k
- Forks
- 639
- Avg merge
- 1d 14h
- Merged PRs (30d)
- 2
Description
Since you touched on a topic of keybindings, currently it's hard to get a sense of what's possible.
- The help panel is hidden under "g?" keybinding by default, and only when nvim-tree updated its way to change keybindings, I discovered that there's a help panel (I was smashing ? and since it did nothing, I just assumed there's no help panel).
- As a user, you think everything useful (or even possible) is in this panel.
So I think the ideal solution would be to:
- Make it clear that g? is a default help panel keybinding. Show "g? - help" somewhere in nvim-tree panel or make it visible in readme.
- Show every possible API command in this help panel, even if it has no keybinding + keybinding if there's one
- Since there are lots of commands, it would be great to group them
This way, you can have minimal keybinding config and it will be extremely easy to copy-paste api function to your on_attach without reading :h nvim-tree
Originally posted by @DeH4er in https://github.com/nvim-tree/nvim-tree.lua/issues/2706#issuecomment-1999552699
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by reviewing the existing g? help panel, the README, the available API commands, and the on_attach configuration referenced in the issue. Determine how keybindings and unbound commands are currently represented, then define the grouping and display behavior before implementing the proposed discoverability improvements.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- lua
- Domain
- developer-experience, documentation
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 30/100