diff --git a/README.md b/README.md
index 9f64e93565d8235227ae5011f1351a806fd9b081..6b929ba8820d6707b1f4c79a68c95ede6961da57 100755
--- a/README.md
+++ b/README.md
@@ -1,3 +1,13 @@
+# Welcome to the Spindle FEA application documentation repository
+
+[![License](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 ![Build Status](https://gitlab.com/pages/plain-html/badges/master/build.svg)
 
-Test
+## How to use the documentation
+
+1. This documentation will be served live in a short while
+2. In the meantime you may clone or download this repository and navigate to ``/public`` subdirectory. Execute ``index.html`` and the interactive documentation will become availablein your browser.
+
+## License
+
+The [MIT license](http://opensource.org/licenses/MIT).