docs/internal/resource-addressing: Add for_each information

website/docs/internals/resource-addressing.html.markdown

@@ -33,23 +33,32 @@ __Resource spec__:
 A resource spec addresses a specific resource in the config. It takes the form:
 
 ```
-resource_type.resource_name[N]
+resource_type.resource_name[resource index]
 ```
 
  * `resource_type` - Type of the resource being addressed.
  * `resource_name` - User-defined name of the resource.
- * `[N]` - where `N` is a `0`-based index into a resource with multiple
+ * `[resource index]` - an optional index into a resource with multiple
-   instances specified by the `count` meta-parameter. Omitting an index when
+   instances, surrounded by square brace characters (`[` and `]`).
-   addressing a resource where `count > 1` means that the address references
-   all instances.
 
 -> In Terraform v0.12 and later, a resource spec without a module path prefix
 matches only resources in the root module. In earlier versions, a resource spec
 without a module path prefix will match resources with the same type and name
 in any descendent module.
 
+__Resource index__:
+
+ * `[N]` where `N` is a `0`-based numerical index into a resource with multiple
+   instances specified by the `count` meta-parameter. Omitting an index when
+   addressing a resource where `count > 1` means that the address references
+   all instances.
+ * `["INDEX"]` where `INDEX` is a alphanumerical key index into a resource with
+   multiple instances specified by the `for_each` meta-parameter.
+
 ## Examples
 
+### count Example
+
 Given a Terraform config that includes:
 
 ```hcl
@@ -72,3 +81,33 @@ aws_instance.web
 ```
 
 Refers to all four "web" instances.
+
+### for_each Example
+
+Given a Terraform config that includes:
+
+```hcl
+resource "aws_instance" "web" {
+  # ...
+  for_each = {
+    "terraform": "value1",
+    "resource":  "value2",
+    "indexing":  "value3",
+    "example":   "value4",
+  }
+}
+```
+
+An address like this:
+
+```
+aws_instance.web["example"]
+```
+
+Refers to only the "example" instance in the config, and an address like this:
+
+```
+aws_instance.web[*]
+```
+
+Refers to all four "web" instances.