[tomohawk]

markdown, in the repo with the code.

[throwawaaarrgh]

Terrible experience for anyone who isn't already a contributor to that repo.

Docs exist for people other than those that wrote them. The people that wrote them don't need to know the information, they already knew it.