Ich nutze sowohl obige Description, in der Markdown und Basic HTML im Gui Editor dargestellt wird (wie z. B. rote Hervorhebungen), als auch Variablen vor bestimmten Stellen im Code, siehe auch Variablen als Mittel der Code Dokumentation - wie macht Ihr das?
Zusätzlich setze ich öfters im Jinja Code ein {# Mein Kommentar #} ein.
Problematisch bei nur # sehe ich, daß beim Wechsel in die Gui Editor diese entfernt werden. Nur wenn man 100%ig im Yaml Editor bleibt, macht es Sinn.