diff --git a/doc/05-repositories.md b/doc/05-repositories.md
index ffa29ede8..0a12da4cc 100644
--- a/doc/05-repositories.md
+++ b/doc/05-repositories.md
@@ -263,6 +263,8 @@ custom repository has priority over packagist. If you want to rename the
 package, you should do so in the default (often master) branch and not in a
 feature branch, since the package name is taken from the default branch.
 
+Also note that the override will not work if you change the `name` property in your forked repository's composer.json file as this needs to match the original for the override to work.
+
 If other dependencies rely on the package you forked, it is possible to
 inline-alias it so that it matches a constraint that it otherwise would not.
 For more information [see the aliases article](articles/aliases.md).