Upstream installation instructions: Docs Edits and Transformations

[guineveresaenger]

Part of pulumi/registry#4749.

#2068 adds the ability to emit the upstream index.md file, where top-level provider information lives, into a docs folder in the Pulumi provider, which is where the registry can find the file if it exists, exactly as we are doing for third party providers today.

To emit these docs properly, the following requirements must be met before emitting this file:

• Apply default doc edit rules
• Convert examples
• Add Hugo shortcodes to any examples so we can obtain the code chooser
• Transform TF names to Pulumi names
• Ability to skip irrelevant sections (e.g. terraform-specific logging, contributing) via docs edit rules
• Nice-to-have: Include pulumi config set... instructions
• Nice-to-have: Show provider config file
• Light rewording of "Argument Reference" "block supports the following"
• Include installation section
• Add registry Hugo frontmatter

[guineveresaenger]

This is ready to be rolled out on select Tier 3 providers. Note that the Akamai provider keeps their installation docs elsewhere so we'll have to come up with an alternative.

[iwahbe]

I have created an issue to track rollout: https://github.com/pulumi/home/issues/3598

[guineveresaenger]

Rollout is complete.

This issue is done.