diff --git a/change-log.md b/change-log.md
index 9b8659f9c..71d379f0b 100644
--- a/change-log.md
+++ b/change-log.md
@@ -5,10 +5,11 @@
 Small BC-break: PHP-DI 3.0 and 3.1 injected properties before calling the constructor. This was confusing and [not supported for internal classes](https://github.com/mnapoli/PHP-DI/issues/74).
 From 3.2 and on, properties are injected after calling the constructor.
 
-* **Lazy injection**: it is now possible to use lazy injection on properties and methods (setters and constructors).
+* **[Lazy injection](doc/lazy-injection.md)**: it is now possible to use lazy injection on properties and methods (setters and constructors).
 * Lazy dependencies are now proxies that extend the class they proxy, so type-hinting works.
+* Addition of the **`ContainerBuilder`** object, that helps to [create and configure a `Container`](doc/container-configuration.md).
+* Some methods for configuring the Container have gone **deprecated** in favor of the `ContainerBuilder`. Fear not, these deprecated methods will remain until next major version (4.0).
 * The container is now auto-registered (as 'DI\Container').
-* `ContainerBuilder` object that helps to create and configure a `Container`
 
 ## 3.1