diff --git a/CHANGELOG b/CHANGELOG
index 187f48f2bc..450b892ecb 100644
--- a/CHANGELOG
+++ b/CHANGELOG
@@ -39,6 +39,13 @@ v2.6.0 (XXXX-XX-XX)
 
 * removed remainders of MRuby integration, removed arangoirb
 
+* simplified `controllers` property in Foxx manifests. You can now specify a filename directly if you only want to use a single file mounted at the base URL of your Foxx app.
+
+* simplified `exports` property in Foxx manifests. You can now specify a filename directly if you only want to export variables from a single file in your Foxx app.
+
+* added support for Node.js-style exports in Foxx exports. Your Foxx exports file can now export arbitrary values using the `module.exports` property instead of adding properties to the `exports` object.
+
+* added `scripts` property to Foxx manifests. You should now specify the `setup` and `teardown` files as properties of the `scripts` object in your manifests.
 
 v2.5.2 (XXXX-XX-XX)
 -------------------
diff --git a/DEPRECATED.md b/DEPRECATED.md
index 3926c353d4..3cd3bbe22a 100644
--- a/DEPRECATED.md
+++ b/DEPRECATED.md
@@ -23,3 +23,11 @@ ArangoDB and shouldn't be used if possible.
 
 ## 2.6
 * Foxx: method `Model#toJSONSchema(id)` has been removed entirely. Please use `Foxx.toJSONSchema(id, model)` instead.
+
+
+## 2.7
+* Foxx: properties `setup` and `teardown` in the manifest are deprecated, they will raise a warning if you use them. Please use the `scripts` property instead.
+
+
+## 2.8
+* Foxx: properties `setup` and `teardown` have been removed entirely. Please use the `scripts` property instead.
\ No newline at end of file