De-listing

Not for merging yet.
Negative. Docstrings are for people that need to use the function. Inline comments are good, but they aren't a substitute. Inline comments can explain the why, but the docstring needs to explain to a potential user what this function does.