Despite the title, my intention is not to start a flame war. I want to discuss docstring conventions in Python, but just as a case study for conventions in general.
This is a companion discussion topic for the original entry at http://amir.rachum.com/blog/2013/07/19/conventions-are-arbitrary-so-use-this-one/