diff --git a/doc/pages/commands.asciidoc b/doc/pages/commands.asciidoc
index 3a1ec818..f8a1e17f 100644
--- a/doc/pages/commands.asciidoc
+++ b/doc/pages/commands.asciidoc
@@ -423,6 +423,10 @@ but not really useful in that context.
 
 == Module commands
 
+In Kakoune, modules are groups of commands that are evaluated all at once. This allows
+lazy loading of complex configurations with a single invocation of *require-moule*.
+The builtin filetype handling for Kakoune is implemented via modules.
+
 *provide-module* [<switches>] <name> <commands>::
     declares a module *name* that is defined by *commands*. *commands* will be
     evaluated as if by source the first time *require-module <name>* is run.