diff --git a/README.vim.md b/README.vim.md
index b2879c9..da061f3 100644
--- a/README.vim.md
+++ b/README.vim.md
@@ -525,19 +525,17 @@ with a lazy extension in `lazy`.
   pkg = {
     enabled = true,
     cache = vim.fn.stdpath("state") .. "/lazy/pkg-cache.lua",
+    versions = true, -- Honor versions in pkg sources
     -- the first package source that is found for a plugin will be used.
     sources = {
       "lazy",
-      "rockspec", -- will only be used when rocks.enabled is true
+      "rockspec",
       "packspec",
     },
   },
   rocks = {
-    enabled = true,
     root = vim.fn.stdpath("data") .. "/lazy-rocks",
     server = "https://nvim-neorocks.github.io/rocks-binaries/",
-    -- use hererocks to install luarocks.
-    hererocks = vim.fn.executable("luarocks") == 0,
   },
   dev = {
     ---@type string | fun(plugin: LazyPlugin): string directory where you store your local plugin projects
diff --git a/doc/lazy.nvim.txt b/doc/lazy.nvim.txt
index 64dac25..e88747b 100644
--- a/doc/lazy.nvim.txt
+++ b/doc/lazy.nvim.txt
@@ -624,19 +624,17 @@ will be added to the plugin’s spec.
       pkg = {
         enabled = true,
         cache = vim.fn.stdpath("state") .. "/lazy/pkg-cache.lua",
+        versions = true, -- Honor versions in pkg sources
         -- the first package source that is found for a plugin will be used.
         sources = {
           "lazy",
-          "rockspec", -- will only be used when rocks.enabled is true
+          "rockspec",
           "packspec",
         },
       },
       rocks = {
-        enabled = true,
         root = vim.fn.stdpath("data") .. "/lazy-rocks",
         server = "https://nvim-neorocks.github.io/rocks-binaries/",
-        -- use hererocks to install luarocks.
-        hererocks = vim.fn.executable("luarocks") == 0,
       },
       dev = {
         ---@type string | fun(plugin: LazyPlugin): string directory where you store your local plugin projects
diff --git a/docs/configuration/index.md b/docs/configuration/index.md
index b9112f0..d80bb58 100644
--- a/docs/configuration/index.md
+++ b/docs/configuration/index.md
@@ -42,19 +42,17 @@ sidebar_position: 5
   pkg = {
     enabled = true,
     cache = vim.fn.stdpath("state") .. "/lazy/pkg-cache.lua",
+    versions = true, -- Honor versions in pkg sources
     -- the first package source that is found for a plugin will be used.
     sources = {
       "lazy",
-      "rockspec", -- will only be used when rocks.enabled is true
+      "rockspec",
       "packspec",
     },
   },
   rocks = {
-    enabled = true,
     root = vim.fn.stdpath("data") .. "/lazy-rocks",
     server = "https://nvim-neorocks.github.io/rocks-binaries/",
-    -- use hererocks to install luarocks.
-    hererocks = vim.fn.executable("luarocks") == 0,
   },
   dev = {
     ---@type string | fun(plugin: LazyPlugin): string directory where you store your local plugin projects