diff --git a/software/cdist/update.mdwn b/software/cdist/update.mdwn
index 9e47fccc..338cf9f8 100644
--- a/software/cdist/update.mdwn
+++ b/software/cdist/update.mdwn
@@ -55,6 +55,11 @@ To upgrade to the lastet version do
 
 ## General Update Instructions
 
+### Updating from 2.3 to 3.0
+
+The **changed** attribute of objects has been removed.
+Use [messaging](man/3.0.0/man7/cdist-messaging.html) instead.
+
 ### Updating from 2.2 to 2.3
 
 No incompatiblities.