Extended the documentation about how and when to use the merge function