diff --git a/ParLib.src/README b/README.md
similarity index 55%
rename from ParLib.src/README
rename to README.md
index 2d00726053dd9a6eb8c05c405b0bafc196bee062..e95f9f0ab4887053aa1409d6c5b8e7da73ebe6f3 100644
--- a/ParLib.src/README
+++ b/README.md
@@ -16,4 +16,27 @@ INM ParLib is a high level library facilitating the coding of finite
 difference and spectral approximation weather and climate prediction 
 models on distributed memory parallel computers.
 
+Since version 2.3 parlib is built using cmake
+to do so
+
+first clone this repo:
+```
+git clone http://tesla.parallel.ru/debol/parlib.git
+```
+to build do:
+```
+mkdir build && cd build
+```
+then export your compilers
+```
+export CC=your_C_compiler
+export CXX=your_CXX_compiler
+export FC=your_fortran_compiler
+```
+then run cmake to configure build
+```
+cmake -DCMAKE_INSTALL_PREFIX=/path/to/install/parlib/to -s ../parlib
+```
+on some clusters higher versions of cmake are aliased with cmake3 (f.ex. Lomonosov-1,2), so use `cmake3` in that case
+