I can not decide if I am sad to see this crap making its way into docstrs here or not.  I personally prefer plain-english descriptive docstrings, because I think it makes you think about the point in the function.  And if you're writing nice small functions, then it is fairly clear what's happening.  Not sure what other people think though.