updated comments for improved docs