Updated README

Author: Denis Trotsenko

README.md

@@ -1,14 +1,16 @@
 # Kotpass 
-![Build & Test](https://github.com/keemobile/kotpass/actions/workflows/gradle.yml/badge.svg) [![](https://jitpack.io/v/keemobile/kotpass.svg)](https://jitpack.io/#keemobile/kotpass)
+![Build & Test](https://img.shields.io/github/actions/workflow/status/keemobile/kotpass/gradle.yml?label=Build%20%26%20Test&style=flat-square)
+[![](https://jitpack.io/v/keemobile/kotpass.svg?style=flat-square)](https://jitpack.io/#keemobile/kotpass) ![badge][badge-jvm]
 
-Library provides reading/writing support for KDBX files in Kotlin (including newest format version 4.1). It's suitable for Mobile, Desktop and Backend JVM projects. Functional style API makes it convenient for MVI/Redux like architectures.
+[badge-jvm]: http://img.shields.io/badge/-JVM-DB413D.svg?style=flat-square
+
+The library offers reading and writing support for [KeePass](https://en.wikipedia.org/wiki/KeePass) (KDBX) files in Kotlin, including the latest format version 4.1. It is suitable for Mobile, Desktop, and Backend JVM projects. The functional style API makes it convenient for MVI-like architectures.
 
 ## See it in action
 
-This library is used as backbone of **KeeMobile** Password Manager, check it out:
+This library is used as backbone of [KeeMobile](https://keemobile.app) password manager, check it out:
 
-[<img src='https://play-lh.googleusercontent.com/VSMqudfH58XxCtn3Il9sUq6JtEHlShVdmxWSpLlLk2JrOG-sE2nbBTLQOkMMbUlSjw=s360-rw' height='80'/>](https://play.google.com/store/apps/details?id=app.keemobile)
-[<img alt='Get it on Google Play' src='https://play.google.com/intl/en_us/badges/static/images/badges/en_badge_web_generic.png' width='200'/>](https://play.google.com/store/apps/details?id=app.keemobile)
+[<img alt='Get it on Google Play' src='https://play.google.com/intl/en_us/badges/static/images/badges/en_badge_web_generic.png' width='160'/>](https://play.google.com/store/apps/details?id=app.keemobile)
 
 ## Installation
 
@@ -30,6 +32,8 @@ dependencies {
 
 ## Usage
 
+### 🧬 [Api reference](https://keemobile.github.io/kotpass)
+
 Reading from file:
 
 ``` kotlin
@@ -40,9 +44,9 @@ val database = File("testfile.kdbx")
         KeePassDatabase.decode(inputStream, credentials)
     }    
 ```
-Database is represented as immutable object, in order to alter it use a set of modifier extensions. 
+`KeePassDatabase` is represented as immutable object, in order to alter it use a set of modifier extensions. 
 
-Each time new Database object is returned:
+Each time new `KeePassDatabase` object is returned:
 
 ``` kotlin
 val groupUuid = UUID.fromString("c997344c-952b-e02b-06a6-29510ce71a12")