diff --git a/docs/whats-new.rst b/docs/whats-new.rst
index 2e02b6780..35e095124 100644
--- a/docs/whats-new.rst
+++ b/docs/whats-new.rst
@@ -4,10 +4,15 @@
 Version history
 ===============
 
-v1.4.0 (pre-release)
---------------------
+v1.4.0 (17.02.2021)
+-------------------
 
-.. admonition:: **New in version 1.4! (pre-release, Feb 07 2021)**
+This a new major update of the OGGM model. It it the result of one year
+of development, with several non-backwards compatible changes.
+
+We recommend all users to update to this version.
+
+.. admonition:: **Major new release 1.4!**
 
     There have been a large number of additions too long to be summarized,
     and the list below is far from complete (we have waited way too long for
@@ -27,6 +32,9 @@ v1.4.0 (pre-release)
        - and much much more....
 
 
+**Note:** not all changes since v1.3.1 are documented below. We'll try to be
+better with documenting changes in the future.
+
 Breaking changes
 ~~~~~~~~~~~~~~~~
 
@@ -83,7 +91,6 @@ Breaking changes
   (:pull:`1099`). By `Fabien Maussion <https://github.com/fmaussion>`_.
 
 
-
 Enhancements
 ~~~~~~~~~~~~