diff --git a/apps/cli/sync.ts b/apps/cli/sync.ts
index 0026e37..a9e0807 100755
--- a/apps/cli/sync.ts
+++ b/apps/cli/sync.ts
@@ -15,9 +15,9 @@
  *   `topicTags` once — when the page is created, or on any later run that
  *   finds the key missing — and never refreshed after, so a sync with nothing
  *   new makes no request. Delete the key to refetch it. The page itself
- *   renders no badges: the docs `PageHeader` slot
+ *   renders no badges: the docs MDX `wrapper`
  *   (`apps/docs/components/ProblemBadges.astro`) turns `topics:` and the
- *   `video:` key `videos.ts` writes into the badge row above the title.
+ *   `video:` key `videos.ts` writes into the badge row under the description.
  * - Every tag a page carries that no campaign topic teaches (not a key of
  *   `apps/docs/topic-landings.ts`) gets a placeholder guide page,
  *   `guides/<slug>.mdx`, with `list:` pointing at LeetCode's problem list for
@@ -400,7 +400,7 @@ function frontmatterTopics(page: string): TopicTag[] {
 /**
  * Placeholder for a tag no campaign topic teaches: the `/guides/<slug>` page a
  * problem's topic badge links to. `list:` is the tag's LeetCode problem list,
- * rendered as a badge by the docs `PageHeader` slot. Written once — the page
+ * rendered as a badge by the docs MDX `wrapper`. Written once — the page
  * is hand-owned from then on.
  */
 function guidePage(tag: TopicTag): string {
diff --git a/apps/cli/videos.ts b/apps/cli/videos.ts
index 91a3134..c746e08 100755
--- a/apps/cli/videos.ts
+++ b/apps/cli/videos.ts
@@ -3,7 +3,7 @@
  * Find the NeetCode explanation video for every docs page that has none.
  *
  * A finished solution page carries frontmatter `video: <YouTube id>` —
- * NeetCode's walkthrough of the problem — which the docs `PageHeader` slot
+ * NeetCode's walkthrough of the problem — which the docs MDX `wrapper`
  * (`apps/docs/components/ProblemBadges.astro`) renders as the red
  * "Explanation" badge beside the topic badges. `sync.ts` never writes that key
  * (it owns `icon:`, `topics:` and `## Solution`), so pages accumulate without