What is a "plugin spec"?

[phwoo]

The documentation (https://lazy.folke.io/spec) lists parameters(?) of what a "plugin spec" should look like, but there is no explanation of what it actually is or does. So, what is it? What do you do with it?

[dpetka2001]

It has an example on the page that you linked.

{ "folke/todo-comments.nvim", opts = {} },

This is a plugin spec. Essentially a table with the plugin name and the opts table where you pass in the plugin's settings that you would like to change or just leave it empty if you want to use the default settings.

If lazy.nvim sees such a plugin spec in a file, then it will install the plugin and load it or not depending on what other properties you passed into the plugin spec.