docstring

include a docstring in the beginning of a file/module, indicating the purpose of a file, under every class declaration and inside every function.

The first line always indicates what the code does and it is the only real essential part (I personally try to always include this in my code). The other parts explain what arguments the function accepts (with types and descriptions) and what it returns.