diff --git a/README.md b/README.md
index 6d4d1afc..f492d465 100644
--- a/README.md
+++ b/README.md
@@ -2,6 +2,11 @@
 
 [![Build Status](https://travis-ci.org/trezor/trezor-core.svg?branch=master)](https://travis-ci.org/trezor/trezor-core) [![gitter](https://badges.gitter.im/trezor/community.svg)](https://gitter.im/trezor/community)
 
+This is the core of the upcoming TREZOR v2. It consists of several parts:
+
+* patched version of [MicroPython](https://github.com/micropython/micropython) - in `vendor/micropython`
+* application logic - in `src`
+
 * [Documentation](docs/)
 
 ##Build instructions for emulator
@@ -46,7 +51,7 @@ Not supported yet ...
 
 ###Linux
 
-For flashing firmware to blank device (without bootloader) by ```make flash```, please install https://github.com/texane/stlink
+For flashing firmware to blank device (without bootloader) by `make flash`, please install [stlink](https://github.com/texane/stlink)
 
 ####Debian/Ubuntu