docstring cleanup in waves