PyLint has added checks to more closely follow [PEP 257](https://www.python.org/dev/peps/pep-0257/) which caused linting to fail. We should update our docstrings so we can revert #1967.
