From e574234efc09e77c8eedebda78ff7c098adbbc96 Mon Sep 17 00:00:00 2001
From: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com>
Date: Fri, 29 Jul 2022 15:24:04 -0400
Subject: [PATCH] Add note about module.path and local module sources

---
 website/docs/language/expressions/references.mdx | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/website/docs/language/expressions/references.mdx b/website/docs/language/expressions/references.mdx
index cada96a0c1..032e6ed5e6 100644
--- a/website/docs/language/expressions/references.mdx
+++ b/website/docs/language/expressions/references.mdx
@@ -118,14 +118,16 @@ to mark the reference as for a data resource.
 
 ### Filesystem and Workspace Info
 
-* `path.module` is the filesystem path of the module where the expression
-  is placed.
-* `path.root` is the filesystem path of the root module of the configuration.
-* `path.cwd` is the filesystem path of the current working directory. In
+The following values are available:
+
+- `path.module` is the filesystem path of the module where the expression
+  is placed. You can use `path.module` in write operations, but we do not recommend this when using local module sources. Multiple invocations of local modules use the same source directory, overwriting the data in `path.module` during each call. This can lead to race conditions and unexpected results.
+- `path.root` is the filesystem path of the root module of the configuration.
+- `path.cwd` is the filesystem path of the current working directory. In
   normal use of Terraform this is the same as `path.root`, but some advanced
   uses of Terraform run it from a directory other than the root module
   directory, causing these paths to be different.
-* `terraform.workspace` is the name of the currently selected
+- `terraform.workspace` is the name of the currently selected
   [workspace](/language/state/workspaces).
 
 Use the values in this section carefully, because they include information