improves in-function documentation