How do you deal with poorly documented plugins?

• lua-language-server

  79 2,988 9.4 Lua

  A language server that offers Lua language support - programmed in Lua

  

So when I find a plugin that has no documentation or only very poor documentation the difference is very jarring. It would be one thing if these plugins just vanished in obscurity, but then you have plugins like nvim-cmp, Sumneko Lua language server (not Neovim specific, but related) or LuaSnip which are actually popular. So how do people figure out how to use them? Do you just copy-paste someone else's config and then shuffle things around until it eventually fits? Are you all a bunch of savants who can read uncommented source code like it's a bedtime story? Am I just too stupid?

• nvim-cmp

  250 7,078 8.1 Lua

  A completion plugin for neovim coded in Lua.

So when I find a plugin that has no documentation or only very poor documentation the difference is very jarring. It would be one thing if these plugins just vanished in obscurity, but then you have plugins like nvim-cmp, Sumneko Lua language server (not Neovim specific, but related) or LuaSnip which are actually popular. So how do people figure out how to use them? Do you just copy-paste someone else's config and then shuffle things around until it eventually fits? Are you all a bunch of savants who can read uncommented source code like it's a bedtime story? Am I just too stupid?

• InfluxDB

  www.influxdata.com sponsored

  Power Real-Time Data Analytics at Scale. Get real-time insights from all types of time series data with InfluxDB. Ingest, query, and analyze billions of data points in real-time with unbounded cardinality.

  

• LuaSnip

  77 2,972 9.1 Lua

  Snippet Engine for Neovim written in Lua.

So when I find a plugin that has no documentation or only very poor documentation the difference is very jarring. It would be one thing if these plugins just vanished in obscurity, but then you have plugins like nvim-cmp, Sumneko Lua language server (not Neovim specific, but related) or LuaSnip which are actually popular. So how do people figure out how to use them? Do you just copy-paste someone else's config and then shuffle things around until it eventually fits? Are you all a bunch of savants who can read uncommented source code like it's a bedtime story? Am I just too stupid?

• completion-nvim

  33 1,009 6.0 Lua

  Discontinued A async completion framework aims to provide completion to neovim's built in LSP written in Lua

  

I have tried to move to nvim-cmp since completion-nvim is dead, but for the life of me I cannot figure out how to make it not automatically select the first completion candidate. If I type date and hit to insert a new line, cmp takes as the "confirm selection" key (because I have mapped it that way) and expands the snippet. I only want to confirm a selection if I actually selected something from the menu. completion-nvim may be dead, but at least its author had the courtesy to write down how to use it in complete plain English sentences instead of broken English one-liners. Eventually I gave up and moved back to the old setup.

• nvim-metals

  12 427 7.9 Lua

  A Metals plugin for Neovim

  

Every software project is WIP to some extent, but that doesn't stop Neovim itself from having really high standards in documentation. A lot of Neovim plugins also have really high standards, such as nvim-metals.

• WorkOS

  workos.com sponsored

  The modern identity platform for B2B SaaS. The APIs are flexible and easy-to-use, supporting authentication, user identity, and complex enterprise features like SSO and SCIM provisioning.

  

Suggest a related project