diff --git a/UPGRADE.md b/UPGRADE.md
index 848a2f6..2311ce9 100644
--- a/UPGRADE.md
+++ b/UPGRADE.md
@@ -139,6 +139,12 @@ $schema->assertValid();
 ``` 
 See https://github.com/webonyx/graphql-php/issues/148
 
+### Deprecated: experimental `GraphQL\Server`
+Use [new PSR-7 compliant implementation](docs/executing-queries.md#using-server) instead.
+
+### Deprecated: experimental `GraphQL\Type\Resolution` interface and implementations
+Use schema [**typeLoader** option](docs/type-system/schema.md#lazy-loading-of-types) instead.
+
 ### Non-breaking: usage on async platforms
 When using the library on async platforms use separate method `GraphQL::promiseToExecute()`. 
 It requires promise adapter in it's first argument and always returns a `Promise`.