Make the difference between Scaladoc generation and Markdown generation clearer
Merge pull request #1931 from wsargent/patch-1

Add section on Markdown generation