Comments
Comments are an important part of .rbInfo files, because they give vital information to the translators about the context of the strings: what are they used for, where do they appear in the User Interface, and so on. Always document your strings if their purpose is not clear.
Remember that the .comment entry must be unique within a key. Try to fit your comments into one line. Alternatively, you can add comments anywhere in the .rbInfo file, using the # character:
#
# AccessPermissionRB defines access control permissions
# that may be granted or denied. <key> is a bit in a long
# permission mask (bits 0-63), -1 is all permissions.
# Keys less than 32 are reserved for PTC.
#
-1.value=Full Control (All)
-1.shortDescription=Full control (all permissions)
-1.longDescription=All rights currently defined and any defined in the future
-1.order=10