data tree DOC lyd_merge examples
diff --git a/src/tree_data.h b/src/tree_data.h
index 9b74f5c..2f48838 100644
--- a/src/tree_data.h
+++ b/src/tree_data.h
@@ -1407,6 +1407,16 @@
  * @brief Merge the source data subtree into the target data tree. Merge may not be complete until validation
  * is called on the resulting data tree (data from more cases may be present, default and non-default values).
  *
+ * Example input:
+ *
+ * source   (A1) - A2 - A3    target   (B1) - B2 - B3
+ *           /\    /\   /\              /\    /\   /\
+ *          ....  .... ....            ....  .... ....
+ *
+ * result target  (A1) - B1 - B2 - B3
+ *                 /\    /\   /\   /\
+ *                ....  .... .... ....
+ *
  * @param[in,out] target Target data tree to merge into, must be a top-level tree.
  * @param[in] source Source data tree to merge, must be a top-level tree.
  * @param[in] options Bitmask of option flags, see @ref mergeoptions.
@@ -1420,6 +1430,16 @@
  * complete until validation called on the resulting data tree (data from more cases may be present, default
  * and non-default values).
  *
+ * Example input:
+ *
+ * source   (A1) - A2 - A3    target   (B1) - B2 - B3
+ *           /\    /\   /\              /\    /\   /\
+ *          ....  .... ....            ....  .... ....
+ *
+ * result target  (A1) - A2 - A3 - B1 - B2 - B3
+ *                 /\    /\   /\   /\   /\   /\
+ *                ....  .... .... .... .... ....
+ *
  * @param[in,out] target Target data tree to merge into, must be a top-level tree.
  * @param[in] source Source data tree to merge, must be a top-level tree.
  * @param[in] options Bitmask of option flags, see @ref mergeoptions.