No matter how you like to participate in developer communities, Pulumi wants to meet you there. If you want to meet other Pulumi users to share use-cases and best practices, contribute code or documentation, see us at an event, or just tell a story about something cool you did with Pulumi, you are part of our community.

Pulumi Community

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.

As for current state: Automation API is definitely a key feature for Pulumi.

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