Commit d3609eefdc6 for woocommerce

commit d3609eefdc69301e13281da05458196c2f20df65
Author: Ján Mikláš <neosinner@gmail.com>
Date:   Mon Sep 14 06:39:33 2026 +0200

    Correct the refund marker migration docblock (#68391)

    * Correct refund marker migration documentation

    * Add changelog entry for migration documentation

diff --git a/plugins/woocommerce/changelog/fix-refund-marker-migration-docblock b/plugins/woocommerce/changelog/fix-refund-marker-migration-docblock
new file mode 100644
index 00000000000..1c94686c398
--- /dev/null
+++ b/plugins/woocommerce/changelog/fix-refund-marker-migration-docblock
@@ -0,0 +1,3 @@
+Significance: patch
+Type: dev
+Comment: Correct the refund marker migration docblock to explain which reports remain affected after a database error.
diff --git a/plugins/woocommerce/includes/wc-update-functions.php b/plugins/woocommerce/includes/wc-update-functions.php
index 5c087077f17..ab59f831f1d 100644
--- a/plugins/woocommerce/includes/wc-update-functions.php
+++ b/plugins/woocommerce/includes/wc-update-functions.php
@@ -3859,8 +3859,9 @@ function wc_update_11201_invalidate_analytics_reports_cache() {
  * now fall back to the order type for such rows; resetting the marker keeps them on the cheap path
  * and restores the Orders report fallback to the refunded order's value.
  *
- * Batches walk the table by order ID. A database error stops the migration and is logged instead
- * of retried, because the report queries stay correct without the reset.
+ * Batches walk the table by order ID. A database error is logged and stops the migration without a retry.
+ * Customer aggregates still use the order type, but unprocessed refunds keep their stale marker,
+ * so the Orders report can retain an incorrect customer_type until those rows are reset.
  *
  * @since 11.2.0
  *