Commenting files as you design and develop them is considered a professional best practice. It provides essential information to current and future stakeholders of projects, including colleagues that will maintain and enhance them to meet the inevitable changing business requirements of a project.
You can now add comments to all rule assets and the discrete components within them. Example include comments on entities and attributes in a Vocabulary and individual rules and cells in a Rulesheet. A new Comments View provides a flexible way to view the comments in a rule asset.