nitpick : have a look at pep257. The docstring should have one headline. Then an empty line with some sentences if needed.