updated comments for documentation