diff --git a/src/adf/document.ts b/src/adf/document.ts
index 61afdc7..375a36f 100644
--- a/src/adf/document.ts
+++ b/src/adf/document.ts
@@ -77,7 +77,6 @@ export function identicalMarks(left: readonly AdfMark[], right: readonly AdfMark
   return marksKey(left) === marksKey(right)
 }
 
-// Callers say when two nodes join.
 export function mergeAdjacentText(nodes: readonly AdfNode[], joins: (previous: AdfNode, node: AdfNode) => boolean): AdfNode[] {
   const merged: AdfNode[] = []
   for (const node of nodes) {
diff --git a/src/markdown/emit/plain-reduction.ts b/src/markdown/emit/plain-reduction.ts
index 00883e0..2545002 100644
--- a/src/markdown/emit/plain-reduction.ts
+++ b/src/markdown/emit/plain-reduction.ts
@@ -54,7 +54,7 @@ export function reduceToPlain(document: AdfDocument): Result<AdfDocument> {
   // docs/decisions.md §Equality is deep: the reduction reads and writes editor-normal ADF.
   const blocks = reduceBlocks(nodeContent(toEditorNormal(document)), { depth: 0, memo: new Map(), path: [] })
   if (!blocks.ok) {
-    // Merging text renumbers siblings, so the caller's document names the path of the refusal the editor-normal one meets.
+    // Merging text renumbers siblings, so a refusal's path comes from the caller's document.
     const raw = reduceBlocks(nodeContent(document), { depth: 0, memo: new Map(), path: [] })
     return !raw.ok && raw.error.code === blocks.error.code ? raw : blocks
   }