First version of the readme document.

Review by @gzm0 @hubertp
add "scala" here for syntax highlighting. Like this:

<pre>
```scala
your code
```
</pre>