diff --git a/examples/with-markdoc/src/components/DocsContent.astro b/examples/with-markdoc/src/components/DocsContent.astro
index 2ab5752e9..162c1fc6d 100644
--- a/examples/with-markdoc/src/components/DocsContent.astro
+++ b/examples/with-markdoc/src/components/DocsContent.astro
@@ -14,6 +14,8 @@ const { Content } = await entry.render();
 	components={{
 		// Pass a mapping from the component name
 		// To an Astro or UI component import
+		// See your `astro.config.mjs` for
+		// for the Markdoc tag mapping
 		Aside,
 	}}
 />
diff --git a/examples/with-markdoc/src/pages/index.astro b/examples/with-markdoc/src/pages/index.astro
index ddb622943..01412cce1 100644
--- a/examples/with-markdoc/src/pages/index.astro
+++ b/examples/with-markdoc/src/pages/index.astro
@@ -11,8 +11,8 @@ const intro = await getEntryBySlug('docs', 'intro');
 		<h1>{intro.data.title}</h1>
 		<!-- `DocsContent` is a thin wrapper around -->
 		<!-- the `Content` component provided by Content Collections, -->
-		<!-- with added Markdoc configuration and component mapping. -->
-		<!-- This allows you to share config wherever you render your Markdoc files. -->
+		<!-- with added configuration for components. -->
+		<!-- This allows you to share global components wherever you render your Markdoc. -->
 		<DocsContent entry={intro} />
 	</main>
 </Layout>