improve documentation on editing & adding docs
mark down to Markdown
Merge pull request #257 from bbodenmiller/patch-3

improve documentation on editing & adding docs