Add UPGRADING notes

symfony · mpdude · Sep 9, 2015 · Sep 9, 2015 · Sep 9, 2015 · Sep 9, 2015
commit d1cb1fd592da59fbf76f2627220d86bd0d9a42d6
diff --git a/UPGRADE-2.8.md b/UPGRADE-2.8.md
@@ -402,3 +402,35 @@ FrameworkBundle
        session:
            cookie_httponly: false
    ```
+
+Config
+------
+
+ * The `\Symfony\Component\Config\Resource\ResourceInterface::isFresh()` method has been
+   deprecated and will be removed in Symfony 3.0 because it assumes that resource
+   implementations are able to check themselves for freshness. 
+
+   If you have custom resources that implement this method, change them to implement the
+   `\Symfony\Component\Config\Resource\SelfCheckingResourceInterface` sub-interface instead
+   of `\Symfony\Component\Config\Resource\ResourceInterface`.
+
+   Before:
+
+   ```php
+   use Symfony\Component\Config\Resource\ResourceInterface;
+
+   class MyCustomResource implements ResourceInterface { ... }
+   ```
+
+   After:
+
+   ```php
+   use Symfony\Component\Config\Resource\SelfCheckingResourceInterface;
+
+   class MyCustomResource implements SelfCheckingResourceInterface { ... }
+   ```
+
+   Additionally, if you have implemented cache validation strategies *using* `isFresh()` 
+   yourself, you should have a look at the new cache validation system based on 
+   `ResourceChecker`s.
+
diff --git a/UPGRADE-3.0.md b/UPGRADE-3.0.md
@@ -1201,3 +1201,10 @@ UPGRADE FROM 2.x to 3.0
  * `Process::setStdin()` and `Process::getStdin()` have been removed. Use
    `Process::setInput()` and `Process::getInput()` that works the same way.
  * `Process::setInput()` and `ProcessBuilder::setInput()` do not accept non-scalar types.
+
+### Config
+
+ * `\Symfony\Component\Config\Resource\ResourceInterface::isFresh()` has been removed. Also,
+   cache validation through this method (which was still supported in 2.8 for BC) does no longer
+   work because the `\Symfony\Component\Config\Resource\BCResourceInterfaceChecker` helper class
+   has been removed as well.