updating the contents as I get familiar with markdown
more documentation updates