diff --git a/UPGRADE.md b/UPGRADE.md
index bb5289e24..d43c4ac13 100644
--- a/UPGRADE.md
+++ b/UPGRADE.md
@@ -26,3 +26,32 @@ Due to the new embed form enhancements:
 * You cannot added the same `sfValidatorErrorSchema` instance twice or more into an `sfValidatorErrorSchema`.
 * The method `sfValidatorErrorSchema::addErrors` only accept an `sfValidatorErrorSchema` instance as argument.
 + The `sfValidatorErrorSchema` constructor no longer accept an array of errors as second argument.
+
+Doctrine & Project configuration
+--------------------------------
+
+Previously, you were able to configure doctrine in your `/config/ProjectConfiguration.class.php` using the method `configureDoctrine`.
+This method isn't called anymore. You now need to connect to the `doctrine.configure` event:
+
+```php
+<?php
+// ...
+
+class ProjectConfiguration extends sfProjectConfiguration
+{
+  public function setup()
+  {
+    // ...
+
+    $this->dispatcher->connect('doctrine.configure', array($this, 'configureDoctrineEvent'));
+  }
+
+  public function configureDoctrineEvent(sfEvent $event)
+  {
+    $manager = $event->getSubject();
+
+    // configure what ever you want on the doctrine manager
+    $manager->setAttribute(Doctrine_Core::ATTR_USE_DQL_CALLBACKS, false);
+  }
+}
+```