diff --git a/packages/boot/test/orchestration/contract-upgrade.test.ts b/packages/boot/test/orchestration/contract-upgrade.test.ts
index 8e37eab1b5d8..c8dcc03f3c95 100644
--- a/packages/boot/test/orchestration/contract-upgrade.test.ts
+++ b/packages/boot/test/orchestration/contract-upgrade.test.ts
@@ -18,12 +18,16 @@ test.after.always(t => t.context.shutdown?.());
 
 /**
  * This test core-evals a buggy installation of the sendAnywhere contract by
- * giving it a faulty `agoricNames` service with a lookup() function returns a
- * promise that never resolves.
+ * giving it a faulty `agoricNames` service with a lookup() function which
+ * returns a promise that never resolves.
  *
  * Because the send-anywhere flow requires a lookup(), it waits forever. This
  * gives us a point at which we can upgrade the vat with a working agoricNames
- * and see that the flow continues from that point.
+ * and see that the flow continues from that point. (The lookup call is not made
+ * directly in a flow, but instead from a host API which uses the retriable
+ * helper. As such it tests both the idempotent retry mechanism of retriable on
+ * upgrades, and the ability to resume an async-flow for which a host vow
+ * settles after an upgrade.)
  */
 test.failing('resume', async t => {
   const { walletFactoryDriver, buildProposal, evalProposal, storage } =