From c71334bb6ecc8640424fba256decb65552f9b19c Mon Sep 17 00:00:00 2001
From: Mahmood Ali <mahmood@hashicorp.com>
Date: Sun, 29 Aug 2021 14:35:09 -0400
Subject: [PATCH] docs: note env and meta map assignment syntax (#11095)

---
 website/content/docs/job-specification/env.mdx  | 10 ++++++++++
 website/content/docs/job-specification/meta.mdx | 10 ++++++++++
 2 files changed, 20 insertions(+)

diff --git a/website/content/docs/job-specification/env.mdx b/website/content/docs/job-specification/env.mdx
index d849fe7d4..400552fd8 100644
--- a/website/content/docs/job-specification/env.mdx
+++ b/website/content/docs/job-specification/env.mdx
@@ -65,6 +65,16 @@ env {
 }
 ```
 
+### Environment variables with dots
+
+Environment variables that aren't valid HCLv2 identifiers, like ones containing `.`, require an alternative map assignment syntax.
+
+```hcl
+env = {
+  "discovery.type" = "single-node"
+}
+```
+
 ### Dynamic Environment Variables
 
 Nomad also supports populating dynamic environment variables from data stored in
diff --git a/website/content/docs/job-specification/meta.mdx b/website/content/docs/job-specification/meta.mdx
index 4f108dfb9..a7d0eca95 100644
--- a/website/content/docs/job-specification/meta.mdx
+++ b/website/content/docs/job-specification/meta.mdx
@@ -79,6 +79,16 @@ meta {
 }
 ```
 
+### Meta keys with dots
+
+Meta keys that aren't valid HCLv2 identifiers, like ones containing `.`, require an alternative map assignment syntax.
+
+```hcl
+meta = {
+  "project.team" = "sre"
+}
+```
+
 [job]: /docs/job-specification/job 'Nomad job Job Specification'
 [group]: /docs/job-specification/group 'Nomad group Job Specification'
 [task]: /docs/job-specification/task 'Nomad task Job Specification'