Don't overlook that action code supports comments, as what makes sense today might not do so tomorrow or in a year's time.
Similarly all user attributes allow a free text description in the Inspector to record the purpose of attribute. Note that existing controls show the data type, default value, etc. so the description is more useful for capturing why the attribute was needed—even if only for ad hoc testing purposes.
For user attribute, take a moment to give them names that are self-explanatory. Clarity of naming is subjective. There is no single right way, so that actual names are a choice for the individual.