Expanded README.md, now similar to README in opm-core.

This, together with the code documentation merged in #32, should answer the need for documentation pointed out in #20.