Answer prose round 1: 0 🔴, 2 🟡 (0 misread); say a note keeps only its link and reword the note comments

src/adf/shown-text.ts

@@ -19,7 +19,7 @@ export function oneLine(text: string): string {
 
 export type ShownNote = { link: LinkAttrs | undefined; name: string }
 
-// The note standing in place of a node that shows no text of its own: `name` what it references, and `link` the node's link, which both writers keep around the note. `undefined` where the node references nothing.
+// The note standing in place of a node that shows no text of its own: `name` is what the node references, `link` its own link, kept around the note. `undefined` where the node references nothing.
 export function shownNote(node: AdfNode): ShownNote | undefined {
   const name = referenceName(node)
   return name === undefined ? undefined : { link: shownLink(node), name }

src/html/carry-content.ts

@@ -40,7 +40,7 @@ function shownPiece(node: AdfNode, lineFeed: string): string {
   return linkedText(node, shownText(node), shownUrl(node), lineFeed)
 }
 
-// As portable markdown writes it inline (docs/decisions.md §The HTML dialect).
+// Links an image as portable markdown does inline (docs/decisions.md §The HTML dialect).
 function linkedImage(media: AdfNode, lineFeed: string): string {
   const image = shownImage(media, shownLink(media)?.href)
   const shown = linkedText(media, image?.text, image?.link, lineFeed)