Automation Descriptions and sub descriptions

At the moment its possible to add a description to the top of an automation.
however some times they get complicated and when coding them i add lots of comments to remind myself what is happening at different stages of the automation.
from time to time its simpler to change a value in the ui, but doing so reformats the yaml and removes all the comments.

Wouldn’t it be great if the ui supported comments?
as well as adding triggers, conditions and actions, you could add a comment.
or alternatively a comment field for each trigger, action or condition.

for example the choose actions, say option1, option2, option3 etc, wouldn’t it be great if you could replace those with something meaningful.

If using the UI your automation is stored as json which does not support comments.

in that case an extra key in each part:

example:

trigger:
  platform: xxx
  comment: this does this, if this happens try this next time
  entity_id:
etc

You pretty much got your wish with 2021.3

alias: can be used just about anywhere in automations now. You can use this for comments.

Really? I wasn’t aware of this. I’ll try it out. Is it used in the UI at all?
Thanks

Not sure…