diff --git a/CHANGELOG.rst b/CHANGELOG.rst
index ccdb00145e58d584b9cf8f23051a6e29881a36ed..4a0dc901e6639897d87424054f27e45af886b36d 100644
--- a/CHANGELOG.rst
+++ b/CHANGELOG.rst
@@ -9,10 +9,27 @@ and this project adheres to `Semantic Versioning`_.
 Unreleased
 ----------
 
+Breaking changes
+~~~~~~~~~~~~~~~~
+
+* The frontend is being rewritten as a Vue.js application compeltely separated from
+  the backend. This requires changes to deployments. The admin docs have been updated
+  accordingly. Administrators need to make sure to read the updated guide before
+  upgrading AlekSIS-Core to this version!
+
+Deprecated
+~~~~~~~~~~
+
+* All frontends using Django views and Django templates are deprecated and support
+  for them will be removed in AlekSIS-Core 4.0. All frontend code must be written in
+  Vue.js and be properly separated from the backend. In the same spirit, all backend
+  features must expose GraphQL APIs for the frontendd to use
+
 Added
 ~~~~~
 
-* Introduce GraphQL API
+* Introduce GraphQL API and Vue.js frontend implementation
+* Introduce webpack bundling for frontend code
 
 Fixed
 ~~~~~