diff --git a/doc/lazy.nvim.txt b/doc/lazy.nvim.txt
index b31fb4e..d16353c 100644
--- a/doc/lazy.nvim.txt
+++ b/doc/lazy.nvim.txt
@@ -542,6 +542,12 @@ ROCKSPEC                                    *lazy.nvim-📦-packages-rockspec*
 When a plugin contains a `*-1.rockspec` file, **lazy.nvim** will automatically
 build the rock and its dependencies.
 
+A **rockspec** will only be used if one of the following is true:
+
+- the package does not have a `/lua` directory
+- the package has a complex build step
+- the package has dependencies (excluding `lua`)
+
 
 PACKSPEC                                    *lazy.nvim-📦-packages-packspec*
 
@@ -736,12 +742,6 @@ will be added to the plugin’s spec.
         skip_if_doc_exists = true,
       },
       state = vim.fn.stdpath("state") .. "/lazy/state.json", -- state info for checker and other things
-      build = {
-        -- Plugins can provide a `build.lua` file that will be executed when the plugin is installed
-        -- or updated. When the plugin spec also has a `build` command, the plugin's `build.lua` not be
-        -- executed. In this case, a warning message will be shown.
-        warn_on_override = true,
-      },
       -- Enable profiling of lazy.nvim. This will add some overhead,
       -- so only enable this when you are debugging lazy.nvim
       profiling = {