improve comments for Yard documentation generation