You can add your own comments to the user-defined attibutes in the Template Editor attribute tree.
For example, MY_contentattributes_userdefined.lst. Do not modify the original contentattributes_userdefined.lst file.
For example:
The comment you added is displayed in the attribute tree in Template Editor: