the readme should explain what `mdoc` is and how to use it

this came up at https://github.com/scala/scala.github.com/pull/675

perhaps there is text in #591 (the issue proposing using tut) and #593 (the PR that added support) that could be used