Merge branch 'main' into renovate/floci-floci

Author: mergify[bot]

website/docs/templates/datasources.mdx

@@ -246,6 +246,62 @@ components:
 ```
 </File>
 
+## Example: Using a Gomplate Datasource
+
+<PillBox>Advanced</PillBox>
+
+Gomplate datasources make external data available inside template expressions.
+
+> **Note:** Atmos [`!include`](/functions/yaml/include) functions and Gomplate datasources both load external data, but they serve different purposes. [`!include`](/functions/yaml/include) imports data directly into the Atmos configuration as part of YAML processing. Gomplate datasources expose data within template expressions, where it can be transformed, filtered, combined, or otherwise manipulated using Gomplate functions before being assigned to a value.
+
+Configure a YAML datasource:
+
+<File title="atmos.yaml">
+
+```yaml
+settings:
+  templates:
+    settings:
+      gomplate:
+        datasources:
+          config:
+            url: "file://config.yaml"
+```
+
+</File>
+
+Use the datasource in template expressions:
+
+<File title="stack.yaml">
+
+```yaml
+components:
+  terraform:
+    app:
+      vars:
+        account_id: '{{ (datasource "config").account_id }}'
+        region: '{{ (datasource "config").region }}'
+```
+
+</File>
+
+Render the final configuration:
+
+<Terminal>
+
+```bash
+atmos describe component app -s dev --query '.vars'
+```
+
+</Terminal>
+
+Example output:
+
+```yaml
+account_id: "111111111111"
+region: "eu-west-2"
+```
+
 ## Using templates in the URLs of `datasources`
 
 <PillBox>Advanced</PillBox>