I’ve created quite a large rule within the Asana Rule Builder which move our tasks throughout multiple boards at the same time based on 8 conditions and on average updating 6 fields of the triggering task based on the condition that is met.
Trying to make documentation on what it all does is quite tedious as I have to then manually recreate all the parts of the rule builder since I can’t fit it all in a screenshot. Additionally any time I want to make an update to the rule my documentation falls out of date.
As such, I’m proposing adding either a Notes area to each rule, perhaps 500character limit field, where you can leave notes on a Rule and how it works so others can view and understand what the rule does. A step beyond this would be having the option to add notes for each of the branches you create with conditionals.
This would be great for other users who may not have editing access but have viewing access of the rules to understand how they work and what their purpose is. Particularly so because in the Activity section of a task users can see rules interacting with a task and click to view the rules.
This would also be great for situations where there is turnover, as having the documentation alongside the rules themselves allows for easier transitioning than trying to locate internal documentation.
While I do understand the thought of breaking rules up to make them simpler to read, the notes would still in that use case be useful as a clear and deliberate way of indicating what they’re intended for.