Hi all... we noticed the Automation API is lacking in documentation a bit... what is the current state and roadmap for this feature? It seems very useful but maybe lacking in support and functionality right now?

What specific things do you feel are missing, if you don’t mind me asking? I’d like to be able to take this back to our documentation team to provide specific recommendations on what our users need.

Lacking documentation was probably the main thing we noticed.

+1! more docs on the methods available would be great take the stack.preview for example. the only way to know what the automation API supports is by going through the SDK docs (which is only available for nodejs) https://www.pulumi.com/docs/reference/pkg/nodejs/pulumi/pulumi/automation/#PreviewOptions so we look at that and it says preview can accept a param called OnEvent but there's no information on what that parameter is or when to use it