diff --git a/CHANGELOG.md b/CHANGELOG.md
index 4dc5207d..ac6f69e1 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -5,7 +5,11 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project will adhere to [Semantic Versioning](https://semver.org/spec/v2.0.0.html) once it reaches  maturity in v1.
 
-## [] - Unreleased
+## [0.1.12] - 2021-04-29
+
+### Added
+
+- slightly improved README
 
 ### Fixed
 
diff --git a/README.md b/README.md
index 4de2756c..478e529e 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,14 @@
-# openapi
+# Blockfrost.io OpenAPI
 OpenAPI specification for Blockfrost.io service
+
+## Current version
+Active version can be found in `released` branch and also in [GitHub releases](https://github.com/blockfrost/openapi/releases).
+
+Development version is in `master` branch and is being merged into `released` upon each release.
+
+## Development
+
+Feel free to open PR against the `master` branch.
+
+## Documentation
+Up-to-date documentation can be found [here](https://docs.blockfrost.io/).
\ No newline at end of file
diff --git a/package.json b/package.json
index e6a4d5e0..f73724e5 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@blockfrost/openapi",
-  "version": "0.1.11",
+  "version": "0.1.12",
   "description": "OpenAPI specifications for blockfrost.io",
   "repository": "git@github.com:blockfrost/openapi.git",
   "author": "admin@blockfrost.io",
diff --git a/swagger.yaml b/swagger.yaml
index 9767bd95..b3598be6 100644
--- a/swagger.yaml
+++ b/swagger.yaml
@@ -1,6 +1,6 @@
 openapi: 3.0.0
 info:
-  version: "0.1.11"
+  version: "0.1.12"
   title: Blockfrost.io ~ API Documentation
   x-logo:
     url: https://staging.blockfrost.io/images/logo.svg