Add installation instructions

[guineveresaenger]

Part of pulumi/home#3598

Generates a provider-side docs/_index.md file with relevant content.

There is an additional text find/replace that is expressed in in docs/index-md-replaces, which will fail with a hard error when the input text is no longer found upstream.

[github-actions]

Does the PR have any schema changes?

Looking good! No breaking changes found.
No new resources/functions.

Maintainer note: consult the runbook for dealing with any breaking changes.

[mjeffryes]

I'm not sure we should skip these sections? Nomad is a hashicorp service, so I assume folks using this provider may need the instructions for working with vault/consul tokens and different regions?

I bet these break because we don't support converting multiple provider configs in a single hcl example though right? But if that's the reason not to include these sections, maybe we should link to a converter issue in the comment

[guineveresaenger]

It's not just that. These sections specifically discuss provider aliases and terraform variables in the text which pushed me over the edge of eliding these.

Correcting this would be a fairly heavy lift rewrite, just to show that each region needs their own token, and that you can set Vault and Consul tokens also on different providers. I can do this, but the cost might be that this will break more upgrades. The file itself doesn't see a lot of action over time so this may be worth it.

[mjeffryes]

I'm ok with just dropping these for now.

[mjeffryes]

I'm ok with just dropping these for now.

[pulumi-bot]

This PR has been shipped in release v2.4.1.