Just capturing a couple thoughts I had of things we might want to document:
The version of the pulumi-terraform-provider plugin is not managed in the users program, so we should maybe make some notes about managing the installed version of the plugin. (Users will need to think about pinning the version if the regenerate SDKs in CI, but we also want them to think about updating it from time to time to get codegen improvements)
We should offer some guidance about what to do with the local SDKs with respect to source control. If only just discussing the two options: either regenerating sdks or checking them in as vendored code.
Just capturing a couple thoughts I had of things we might want to document: