Update readme.rst

updated documentation to be continued in a more standard shape.