The docs should be more readable and organized.

Small readme readability improvement.

Improved docs

Fixed code blocks in readme

One more try at code blocks

...