diff --git a/UPGRADE-2.7.md b/UPGRADE-2.7.md
index 0121a39e20..8e6a99c62e 100644
--- a/UPGRADE-2.7.md
+++ b/UPGRADE-2.7.md
@@ -646,6 +646,34 @@ FrameworkBundle
    }
    ```
 
+ * The assets settings under `framework.templating` were deprecated and will be removed in Symfony 3.0. Use `framework.assets` instead.
+
+   Before:
+
+   ```yml
+   framework:
+       templating:
+           assets_version: 'v123'
+           assets_version_format: '%%s?version=%%s'
+           assets_base_urls:
+               http: ['http://cdn.example.com']
+               ssl:  ['https://secure.example.com']
+           packages:
+               # ...
+   ```
+
+   After:
+
+   ```yml
+   framework:
+       assets:
+           version: 'v123'
+           version_format: '%%s?version=%%s'
+           base_urls: ['http://cdn.example.com', 'https://secure.example.com']
+           packages:
+               # ...
+   ```
+
 Security
 ---------------
 
diff --git a/UPGRADE-3.0.md b/UPGRADE-3.0.md
index 5d36e2675a..1d97d78a82 100644
--- a/UPGRADE-3.0.md
+++ b/UPGRADE-3.0.md
@@ -883,6 +883,34 @@ UPGRADE FROM 2.x to 3.0
            engines: ['php']
    ```
 
+ * The assets settings under `framework.templating` were moved to `framework.assets`.
+
+   Before:
+
+   ```yml
+   framework:
+       templating:
+           assets_version: 'v123'
+           assets_version_format: '%%s?version=%%s'
+           assets_base_urls:
+               http: ['http://cdn.example.com']
+               ssl:  ['https://secure.example.com']
+           packages:
+               # ...
+   ```
+
+   After:
+
+   ```yml
+   framework:
+       assets:
+           version: 'v123'
+           version_format: '%%s?version=%%s'
+           base_urls: ['http://cdn.example.com', 'https://secure.example.com']
+           packages:
+               # ...
+   ```
+
  * The `form.csrf_provider` service is removed as it implements an adapter for
    the new token manager to the deprecated
    `Symfony\Component\Form\Extension\Csrf\CsrfProvider\CsrfProviderInterface`