terraform/website/docs/configuration
Martin Atkins 67311f73fd website: Draw better attention to for and for_each patterns
When helping folks in the community forum, I commonly see questions around
more complex patterns in transforming deep data structures into different
shapes to work with for_each. We have examples of these patterns in the
docs for the functions that they rely on, but they were not previously
very discoverable in the main configuration language documentation
sections.

Here I've moved the "Using Expressions in for_each" subsection on the
Resources page above some of the other sub-sections to hopefully make it
easier to see, and written out in more detail the two specific patterns
that answer a significant number of for_each-related user questions in
the hope that readers will be more likely to realize that the links are
relevant to what their goals.

I also added some more elaboration about the behavior of converting from
list to set in the "Using Sets" subsection, because this feature is often
a user's first encounter with the set data type and I've inferred from
some of the questions I've answered that a number of Terraform users don't
have prior experience with set data types in other languages to draw
assumptions from.

Finally, I added some similar links to the for_each patterns within the
for expression documentation itself, to try to make those examples more
visible to those who might be discovering the documentation in a different
sequence, e.g. by following a deep link shared in an answer to a question
in the community forum.
2020-06-01 14:17:47 -07:00
..
functions configs: Custom variable validation is no longer experimental 2020-05-28 16:07:59 -07:00
attr-as-blocks.html.md Minor spelling fixes 2019-06-13 15:36:14 +01:00
data-sources.html.md depends_on doc updates 2020-05-28 16:17:01 -04:00
expressions.html.md website: Draw better attention to for and for_each patterns 2020-06-01 14:17:47 -07:00
functions.html.md website: Version notes: Add new -> old links to 0.12 language docs (except function pages) 2019-02-01 17:20:54 -08:00
index.html.md website: Fix typo in the configuration language introduction page 2019-05-08 16:31:37 -07:00
locals.html.md website: Update "Local Values" docs to use v0.12 syntax in example 2019-04-18 09:03:34 -07:00
modules.html.md depends_on doc updates 2020-05-28 16:17:01 -04:00
outputs.html.md Update outputs.html.md 2019-12-17 07:33:11 -05:00
override.html.md website: Version notes: Add new -> old links to 0.12 language docs (except function pages) 2019-02-01 17:20:54 -08:00
providers.html.md website: Initial documentation for provider_installation in the CLI config 2020-04-23 10:52:01 -07:00
resources.html.md website: Draw better attention to for and for_each patterns 2020-06-01 14:17:47 -07:00
style.html.md website: Version notes: Add new -> old links to 0.12 language docs (except function pages) 2019-02-01 17:20:54 -08:00
syntax-json.html.md website/docs: provider aliases in the JSON format 2020-05-13 15:52:26 +02:00
syntax.html.md Fix link in syntax docs 2019-10-24 11:57:08 -04:00
terraform-enterprise.html.md Remove links to legacy Terraform Enterprise docs 2019-06-07 13:47:12 -04:00
terraform.html.md Add support for provider metadata to modules. (#22583) 2020-03-05 16:53:24 -08:00
types.html.md Update maps docs to reflect v0.12 colon behavior 2020-04-26 17:52:08 -06:00
variables.html.md configs: Custom variable validation is no longer experimental 2020-05-28 16:07:59 -07:00