Merge commit '8d9511a08f14260cbfb73119e4afae50e5a9966d'

docs/content/en/functions/getenv.md

@@ -1,30 +1,43 @@
 ---
 title: getenv
-description: Returns the value of an environment variable.
+description: Returns the value of an environment variable, or an empty string if the environment variable is not set.
 date: 2017-02-01
 publishdate: 2017-02-01
-lastmod: 2017-02-01
+lastmod: 2021-11-26
 categories: [functions]
 menu:
   docs:
     parent: "functions"
 keywords: []
-signature: ["getenv VARIABLE"]
+signature: ["os.Getenv VARIABLE", "getenv VARIABLE"]
 workson: []
 hugoversion:
 relatedfuncs: []
 deprecated: false
 aliases: []
 ---
+Examples:
 
-Takes a string containing the name of the variable as input. Returns
-an empty string if the variable is not set, otherwise returns the
-value of the variable.
-
-```
-{{ getenv "HOME" }}
+```go-html-template
+{{ os.Getenv "HOME" }} --> /home/victor
+{{ os.Getenv "USER" }} --> victor
 ```
 
-{{% note %}}
-In Unix-like environments, the variable must also be exported in order to be seen by `hugo`.
-{{% /note %}}
+You can pass values when building your site:
+
+```bash
+MY_VAR1=foo MY_VAR2=bar hugo
+
+OR
+
+export MY_VAR1=foo
+export MY_VAR2=bar
+hugo
+```
+
+And then retrieve the values within a template:
+
+```go-html-template
+{{ os.Getenv "MY_VAR1" }} --> foo
+{{ os.Getenv "MY_VAR2" }} --> bar
+```