comment to clarify allowed values of properties