diff --git a/CHANGES.md b/CHANGES.md
index bccdb4f..150ed02 100644
--- a/CHANGES.md
+++ b/CHANGES.md
@@ -1,4 +1,9 @@
 # opensensmapr changelog
+This project does its best to adhere to semantic versioning.
+
+### 2017-11-29: v0.3.1
+- compatibility with latest API format (#4)
+- add package documentation under `?opensensmapr` (#5)
 
 ### 2017-09-04: v0.3.0
 - add utility functions: `filter`, `mutate`, `[`, `st_as_sf` for classes `sensebox` and `osem_measurements`
diff --git a/DESCRIPTION b/DESCRIPTION
index 850462e..b612826 100644
--- a/DESCRIPTION
+++ b/DESCRIPTION
@@ -1,7 +1,7 @@
 Package: opensensmapr
 Type: Package
 Title: Work with Sensor Data from opensensemap.org in R
-Version: 0.3.0
+Version: 0.3.1
 URL: http://github.com/noerw/opensensmapR
 BugReports: http://github.com/noerw/opensensmapR/issues
 Imports:
@@ -14,7 +14,7 @@ Suggests:
     knitr,
     rmarkdown
 Author: Norwin Roosen
-Maintainer: Norwin Roosen <noerw@gmx.de>
+Maintainer: Norwin Roosen <maintenance@nroo.de>
 Description: This package ingests data (measurements, sensorstations) from the
     API of opensensemap.org for analysis in R.
     The package aims to be compatible with sf and the tidyverse.