From dc148054b28efb5abe4b2eae88e4ca8e68c1b4cf Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Henrik=20tom=20W=C3=B6rden?= <h.tomwoerden@indiscale.com>
Date: Thu, 1 Feb 2024 17:28:35 +0100
Subject: [PATCH] DOC: add hint

---
 src/doc/macros.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/src/doc/macros.rst b/src/doc/macros.rst
index 560827e6..5329ca6d 100644
--- a/src/doc/macros.rst
+++ b/src/doc/macros.rst
@@ -192,6 +192,9 @@ The example will be expanded to:
           a: '5'
 
 
+Note, that you need to make sure that subsequent macro calls do not
+use the same top level key. Because later versions would overwrite previous
+ones. Here we used ``$macro_name`` to prevent that.
 
 
 Limitation
-- 
GitLab