should some of these comments become a docstring?