updated comment docs