clarify required properties