diff --git a/doc/04-schema.md b/doc/04-schema.md
index cd0c86a96..76cef57e2 100644
--- a/doc/04-schema.md
+++ b/doc/04-schema.md
@@ -288,17 +288,6 @@ Example:
 precedence. This also means that custom repositories can override packages
 that exist on packagist.
 
-You can also disable the packagist repository by setting `packagist` to
-`false`.
-
-    {
-        "repositories": [
-            {
-                "packagist": false
-            }
-        ]
-    }
-
 ## config
 
 A set of configuration options. It is only used for projects.
diff --git a/doc/05-repositories.md b/doc/05-repositories.md
index 6c84ccd65..e26cc49af 100644
--- a/doc/05-repositories.md
+++ b/doc/05-repositories.md
@@ -249,3 +249,16 @@ package repository definitions. It will fetch all the packages that are
 
 Check [the satis GitHub repository](https://github.com/composer/satis) for more
 information.
+
+## Disabling packagist
+
+You can disable the default packagist repository by adding this to your
+`composer.json`:
+
+    {
+        "repositories": [
+            {
+                "packagist": false
+            }
+        ]
+    }