diff --git a/doc/docs.md b/doc/docs.md
index 6d0e1a5fb0..21396f980d 100644
--- a/doc/docs.md
+++ b/doc/docs.md
@@ -343,11 +343,12 @@ the expression `T(v)` converts the value `v` to the
 type `T`.
 
 Unlike most other languages, V only allows defining variables in functions.
-Global (module level) variables are not allowed. There's no global state in V.
+By default V does not allow **global variables**. See more [details](#global-variables).
 
 For consistency across different code bases, all variable and function names
 must use the `snake_case` style, as opposed to type names, which must use `PascalCase`.
 
+
 ### Mutable variables
 
 ```v