diff --git a/CHANGELOG.md b/CHANGELOG.md
index f8b8f58..53c9951 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -9,7 +9,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Changed
 ### Removed
 
-## [5.1.0] 2021-05-24
+## [6.0.0] 2021-05-26
 ### Added
 - Child contracts
 - `Chain.clone`
diff --git a/README.md b/README.md
index a7c982c..6703cdd 100644
--- a/README.md
+++ b/README.md
@@ -15,11 +15,12 @@ The compiler is currently being used three places
 
 ## Versioning
 
-`aesophia` has a version that is only loosely connected to the version of the
-Aeternity node - in principle they will share the major version but not
-minor/patch version. The `aesophia` compiler version MUST be bumped whenever
-there is a change in how byte code is generated, but it MAY also be bumped upon
-API changes etc.
+Versioning should follow [semantic versioning](https://semver.org/spec/v2.0.0) guidelines. Id est, given a version number MAJOR.MINOR.PATCH, increment the:
+
+- MAJOR version when you make incompatible API changes
+- MINOR version when you add functionality in a backwards compatible manner
+- PATCH version when you make backwards compatible bug fixes
+
 
 ## Interface Modules