DOC: add docstring for deprecation
Fix mistake in example