diff --git a/CHANGES.md b/CHANGES.md
index 210194b..daf5630 100644
--- a/CHANGES.md
+++ b/CHANGES.md
@@ -1,6 +1,14 @@
 # opensensmapr changelog
 This project does its best to adhere to semantic versioning.
 
+### 2018-05-25: v0.4.0
+- add caching feature for requests; see vignette osem-serialization
+- add vignette osem-serialization
+- add vignette osem-history
+- fix broken parameter check for osem_measurements(phenomenon = )
+- increased test coverage
+- package ready for CRAN
+
 ### 2018-01-13: v0.3.2
 - hide download progress in non interactive sessions (#11)
 - fix `print.osem_measurements()`
diff --git a/DESCRIPTION b/DESCRIPTION
index 601d940..61b2f56 100644
--- a/DESCRIPTION
+++ b/DESCRIPTION
@@ -1,7 +1,7 @@
 Package: opensensmapr
 Type: Package
 Title: Client for the Data API of openSenseMap.org
-Version: 0.3.3
+Version: 0.4.0
 URL: http://github.com/noerw/opensensmapR
 BugReports: http://github.com/noerw/opensensmapR/issues
 Imports: