docs: added after/wants to migration guide and added an example that sets a key mode

README.md

@@ -254,7 +254,8 @@ return {
   {
     "monaqa/dial.nvim",
     -- lazy-load on keys
-    keys = { "<C-a>", "<C-x>" },
+    -- mode is `n` by default. For more advanced options, check the section on key mappings
+    keys = { "<C-a>", { "<C-x>", mode = "n" } },
   },
 
   -- local plugins need to be explicitly configured with dir
@@ -582,6 +583,8 @@ For a real-life example, you can check my personal dots:
 - `lock` ➡️ `pin`
 - `disable=true` ➡️ `enabled = false`
 - `tag='*'` ➡️ `version="*"`
+- `after` ℹ️ **_not needed_** for most use-cases. Use `dependencies` otherwise.
+- `wants` ℹ️ **_not needed_** for most use-cases. Use `dependencies` otherwise.
 - `module` is auto-loaded. No need to specify
 - `keys` spec is [different](#%EF%B8%8F-lazy-key-mappings)
 

TODO.md

@@ -63,5 +63,5 @@
 - [x] Most emojis in "Configuration" aren't shown for me.
 - [x] add section on how to uninstall
 - [x] add `:Packadd` command or something similar
-- [ ] headless install
-- [ ] better keys handling
+- [x] headless install
+- [x] better keys handling

lua/lazy/example.lua

@@ -69,7 +69,8 @@ return {
   {
     "monaqa/dial.nvim",
     -- lazy-load on keys
-    keys = { "<C-a>", "<C-x>" },
+    -- mode is `n` by default. For more advanced options, check the section on key mappings
+    keys = { "<C-a>", { "<C-x>", mode = "n" } },
   },
 
   -- local plugins need to be explicitly configured with dir