This message was deleted.

You can instantiate multiple versions of a provider in YAML, i.e.

resources:
  aws1:
    type: pulumi:providers:aws
    defaultProvider: true
    options:
      region: us-east-1
  aws2:
    type: pulumi:providers:aws
    options:
      region: us-west-1
  bucket1:
    type: aws:s3:Bucket
    properties:
      acl: private
      tags:
        Environment: Dev
        Name: Bucket in us-east-1
  bucket2:
    type: aws:s3:Bucket
    properties:
      acl: private
      tags:
        Environment: Dev
        Name: Bucket in us-east-2
    options:
      provider: ${aws2}

How to do so is sort of explained on the YAML reference page, and on the individual provider doc itself, but agree that YAML should be on the Resource providers page

Thanks for the detailed answer!