[Docs] Clarify Dependency Management in Style Guide

[makmn1]

I was reading through the Terraform docs and got confused by a statement which I believe is unclear or incorrect. This is on the "Style Guide" page under "Code style" (link):

Let your code build on itself: define dependent resources after the resources that reference them.

The line above states that dependent resources should be defined after the resources that reference them (so other dependent resources that depend on this dependent resource). However, shouldn't resources always be defined before the resources that reference them? That's what I gather from the "Let your code build on itself" principle and examples elsewhere in the docs.

I think the following change would make this clearer and self-explanatory:

Let your code build on itself: define dependent resources after the resources they reference.

This change clarifies that referenced resources should be defined before the resources that depend on them, which isn't what the original text seems to describe.

[hashicorp-cla-app]

All committers have signed the CLA.

[crw]

Thanks for this submission! I will notify the docs team.