diff --git a/website/src/docs/reference/templating.md b/website/src/docs/reference/templating.md
index b100abc468..3daaad5cb2 100644
--- a/website/src/docs/reference/templating.md
+++ b/website/src/docs/reference/templating.md
@@ -565,6 +565,9 @@ tasks:
       - echo "{{.MULTILINE | catLines}}"          # Replace newlines with spaces
 ```
 
+In pipeline form, `join` receives the list from the left-hand side. The
+equivalent non-pipeline form is `{{join " " .WORDS}}`.
+
 #### Shell Argument Parsing
 
 ```yaml