I'm loving Pyscript for my automations in HA. For any developer, it's the way to write home automations as far as I'm concerned, espicially compared to the HA UI, of the yaml automation approach.

However, I find the documentation very lacking. It really needs some example code. Take the @state_active decorator. From the couple of short paragraphs describing this, I can't really figure out how I use it, or why I would use it over a @state_trigger.

Are there any plans to improve the documentation and add some example code to things like this?