I had an idea recently that I think could potentially help newcomers. What if we provided a heavily documented
kakrc that could be easily copied over to the individuals
$XDF_CONFIG_HOME/kak/ to jumpstart their own personal configuration.
There is a lot of documentation and tips around user configuration but its kinda scattered in different places. This would allow people to see what options are available, learn about them in one place, and this all happens from within the Kakoune, similar to how people learn vim from
vimtutor, where they can get instant feedback (via sourcing). I feel like this method fits neatly in line with the self-documenting principle of Kakoune. There’s also the added side effect that something like this might deter newcomers from copying other configs from around the internet which could have unintended side effects.
This isn’t a completely new idea obviously. A project that takes this approach and does it well is the very popular terminal Alacritty. There is also idiomatic-vimrc, which does a great job of empowering vim users to understand how they can configure their editor.
Ideally, the idiomatic kakrc would be a combination of these two, then all you have to do is let people know about it
Ready to make Kakoune your own?:
cp /path/to/kakoune/contrib/kakrc $XDG_CONFIG_HOME/kak/kakrc