Docstrings vs Markdown Docs: What Should Developers Actually Write?

Every developer hits this wall eventually. You know you should document your code. You've heard the...