Fixing the docs to make them nicer rendered

i know it's details but it bugs the hell out of me when i see trailing spaces. and it should render nicer as markdown.