linting, docstrings and a required argument for identify