Adjust doc structure

[the-mayer]

At some point it might be good to consider one sentence per line structure. This makes maintenance easier sometimes.

Originally posted by @d33bs in #6 (comment)