diff --git a/CHANGELOG.md b/CHANGELOG.md
index a895e9db65..7bed8ae1d5 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,28 @@
 # Changelog
 
+## 35.5.0 [#1038](https://github.com/openfisca/openfisca-core/pull/1038)
+
+#### New Features
+
+- Introduce `openfisca_core.variables.typing`
+  - Documents the signature of formulas
+  - Note: as formulas are generated dynamically, documenting them is tricky
+
+#### Bug Fixes
+
+- Fix the official doc
+  - Corrects malformed docstrings
+  - Fix missing and/ou outdated references
+
+#### Technical Changes
+
+- Add tasks to automatically validate that changes do not break the documentation
+
+#### Documentation
+
+- Add steps to follow in case the documentation is broken
+- Add general documenting guidelines in CONTRIBUTING.md
+
 ### 35.4.2 [#1026](https://github.com/openfisca/openfisca-core/pull/1026)
 
 #### Bug fix
diff --git a/setup.py b/setup.py
index d67113a6fd..88e2772a2c 100644
--- a/setup.py
+++ b/setup.py
@@ -36,7 +36,7 @@
 
 setup(
     name = 'OpenFisca-Core',
-    version = '35.4.2',
+    version = '35.5.0',
     author = 'OpenFisca Team',
     author_email = 'contact@openfisca.org',
     classifiers = [