diff --git a/CHANGELOG-2.1.md b/CHANGELOG-2.1.md
index 765ea1d948..c9b029b3c4 100644
--- a/CHANGELOG-2.1.md
+++ b/CHANGELOG-2.1.md
@@ -36,14 +36,17 @@ To get the diff between two versions, go to https://github.com/symfony/symfony/c
 
 ### SecurityBundle
 
- * [BC BREAK] The custom factories for the firewall configuration are now registered during the build method of
-   bundles instead of being registered by the end-user.
+ * [BC BREAK] The custom factories for the firewall configuration are now
+   registered during the build method of bundles instead of being registered
+   by the end-user (you need to remove the 'factories' keys in your security
+   configuration).
 
- * [BC BREAK] The Firewall listener is now registered after the Router one.
-   It means that specific Firewall URLs (like /login_check and /logout must now have proper
-   route defined in your routing configuration)
+ * [BC BREAK] The Firewall listener is now registered after the Router one. It
+   means that specific Firewall URLs (like /login_check and /logout must now
+   have proper route defined in your routing configuration)
 
- * [BC BREAK] refactored the user provider configuration. The configuration changed for the chain provider and the memory provider:
+ * [BC BREAK] refactored the user provider configuration. The configuration
+   changed for the chain provider and the memory provider:
 
    Before: