Add date-stamped, permanent, append-only comments to individual instances of apps, particularly RM and HSM.
Since rules cannot be saved, versioned, or have in-line comments (as compared to source code), it is very difficult for end users to track the status of rules (the intent of a rule, any odd behavior, etc).
Examples:
-
Maintain a comment that the SAGE doorbell device has numerous false alerts when the timeBetweenPresses value is less than 15. I arrived at this value over time (tweaking the rule). It would be very helpful to have a record with the rationale behind the value, and recording the various timeBetweenPresses values that were used and their behavior.
-
Keep a comment in a rule explaining why/how it works.