diff --git a/src/tree_data.h b/src/tree_data.h
index 782c29341..fc0881aeb 100644
--- a/src/tree_data.h
+++ b/src/tree_data.h
@@ -1554,8 +1554,8 @@ LIBYANG_API_DECL LY_ERR lyd_new_attr2(struct lyd_node *parent, const char *modul
  * and @p value is set, the predicate is preferred.
  *
  * For key-less lists, positional predicates must be used (indices starting from 1). For non-configuration leaf-lists
- * either positional predicate can be used or leaf-list predicate, when an instance is always created at the end.
- * If no predicate is used for these nodes, they are always created.
+ * (or lists) either positional predicate can be used or leaf-list (or key) predicate, when an instance is always
+ * created at the end. If no predicate is used for these nodes, they are always created.
  *
  * @param[in] parent Data parent to add to/modify, can be NULL. Note that in case a first top-level sibling is used,
  * it may no longer be first if @p path is absolute and starts with a non-existing top-level node inserted