diff --git a/docs/configuration/index.md b/docs/configuration/index.md
index d80bb58..b9112f0 100644
--- a/docs/configuration/index.md
+++ b/docs/configuration/index.md
@@ -42,17 +42,19 @@ 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",
+      "rockspec", -- will only be used when rocks.enabled is true
       "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/lua/build.lua b/lua/build.lua
index c54c254..f7bf50a 100644
--- a/lua/build.lua
+++ b/lua/build.lua
@@ -161,6 +161,8 @@ function M.readme(readme, mds, transform)
 end
 
 function M.update()
+  M.themes()
+  M.docs()
   M.readme("README.vim.md")
   M.readme("README.md", {
     "README.header.md",
@@ -169,8 +171,6 @@ function M.update()
   }, function(s)
     return s:gsub("\n# 🚀 Getting Started", "\n")
   end)
-  M.themes()
-  M.docs()
   vim.cmd.checktime()
 end