From 67b94798b796e120f23745700b73d30e64828478 Mon Sep 17 00:00:00 2001
From: kirkrodrigues <2454684+kirkrodrigues@users.noreply.github.com>
Date: Wed, 21 Feb 2024 19:13:40 -0500
Subject: [PATCH] docs: specify that variable declaration order is respected
 (#1510)

---
 docs/docs/api_reference.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/docs/docs/api_reference.md b/docs/docs/api_reference.md
index 7a5e02c9..a62266b2 100644
--- a/docs/docs/api_reference.md
+++ b/docs/docs/api_reference.md
@@ -214,6 +214,19 @@ vars:
 
 :::
 
+:::info
+
+In a variables map, variables defined later may reference variables defined
+earlier (declaration order is respected):
+
+```yaml
+vars:
+  FIRST_VAR: "hello"
+  SECOND_VAR: "{{.FIRST_VAR}} world"
+```
+
+:::
+
 ### Task
 
 | Attribute       | Type                               | Default                                               | Description                                                                                                                                                                                                                                                                                              |