diff --git a/NEWS.org b/NEWS.org
index 3d44361e..0bf26bfe 100644
--- a/NEWS.org
+++ b/NEWS.org
@@ -114,6 +114,23 @@
 
     - Updated the ~mug~ toy UI to use Webkit2/GTK+. Note that this is just a toy
       which is not meant for distribution. ~msg2pdf~ is disabled for now.
+      
+      
+*** How to upgrade
+
+    - upgrade mu to the latest stable version
+
+    - shut down emacs
+
+    - Run `mu init' in a terminal
+
+    - Make sure mu init points to the right Maildir folder and add your email address(es) the following way: 
+      `mu init --maildir=~/Maildir --my-address=jim@example.com --my-address=bob@example.com'
+
+    - once this is done run `mu index'
+
+    - Don't forget to delete your old mail cache location if necessary (see release notes for more detail). 
+  
 
 ** 1.2