docs: update splat expressions in directives

[bendrucker]

Updates the Expressions > Strings and Templates docs to use the recommend splat expression syntax, with square brackets. While Terraform continues to support the .* syntax for resources with count, the docs describe them as "legacy 'attribute-only' splat expressions."

For good measure, I tested to confirm this works:

output "ips" {
  value = <<-EOF
    %{ for ip in aws_instance.example[*].private_ip }
    server ${ip}
    %{ endfor }
  EOF
}

resource "aws_instance" "example" {
  count = 2
  instance_type = "t3.nano"
  ami = "ami-0d593311db5abb72b"
}

Apply complete! Resources: 2 added, 0 changed, 0 destroyed.

Outputs:

ips = <<EOT

server 172.31.52.27

server 172.31.53.123


EOT

[bendrucker]

See also terraform-linters/tflint-ruleset-terraform#43 — TFLint will soon be able to detect the use of legacy splat expressions in directives and recommend that square brackets be used instead.

[crw]

Thanks for this submission! It is appreciated! I've notified the docs team.

[trujillo-adam]

Thanks for the updates!

[github-actions]

Reminder for the merging maintainer: if this is a user-visible change, please update the changelog on the appropriate release branch.

[github-actions]

I'm going to lock this pull request because it has been closed for 30 days ⏳. This helps our maintainers find and focus on the active contributions.
If you have found a problem that seems related to this change, please open a new issue and complete the issue template so we can capture all the details necessary to investigate further.