docstring. do note best practices is to internally trigger this kind of thing, but...