great question! I am excited to hear what the community comes back with. Internally we try and document everything using our company intranet, as well as leave copious notes inside the automations themselves.
We don’t have a specific doc structure, other than to use tables for tags, use clear tag prefixes
VERTICAL: Ecommerce for example.
I also have several macro automations that span many automations inside the application. I will occasionally draw those with some flowchart software (I use SimpleMind).
I will also include short animations I have created with Keynote to demonstrate how different contacts with different attributes (custom fields, tags, etc) will move through those larger automations.
It does take some time, and I should be much more verbose about all of them, but you are right it is absolutely crucial if you have several people all working on automations.