@alex-courtis Please merge asap!

@gegoune I think we should provide and example somewhere in docs. Otherwise it's a black box for unfamiliar people.

I am not against examples of course, is just that this one was not well placed. Other api don't provide any examples at all and this is what it should stay as. We can provide some example api usages on top of api help, more generic ones.

@gegoune But where should such docs be placed?

Actually there is already an example of how to use API functions in :h nvim-tree-mappings. Do you think it could be improved?

API would be great!

@gegoune Well, it doesn't say explicitly that api.node.<*> namespace can be used:

It shouldn't list all the available namespaces, local api = require('nvim-tree.api') is provided indicating all api can be used.

This is out of topic here now. If you think documentation can be improved please open new issue or better yet a PR.

@

Well I could have made an improvement via this PR, but anyway.

That wasn't what we wanted to add to docs. Please open new issue if you want to continue this conversation.

How about we just add a Recipe ?

The :help is factual and correct.