chore: added comments

Author: stevedylandev

source.config.ts

@@ -7,9 +7,13 @@ import { remarkMdxMermaid } from "fumadocs-core/mdx-plugins";
 // see https://fumadocs.vercel.app/docs/mdx/collections#define-docs
 export const docs = defineDocs({
 	dir: "content",
+	// Async mode - enables runtime compilation for faster dev server startup
 	docs: {
 		async: true,
 	},
+	// To switch back to sync mode (pre-compilation), comment out the docs config above and uncomment below:
+	// (sync mode - pre-compiles all content at build time)
+	// No additional config needed for sync mode - just remove the docs config
 });
 
 export default defineConfig({

src/app/(docs)/[...slug]/page.tsx

@@ -16,9 +16,13 @@ export default async function Page(props: {
 	const page = source.getPage(params.slug);
 	if (!page) notFound();
 
-	// Load the compiled content asynchronously
+	// Async mode - load the compiled content at runtime
 	const { body: MDXContent, toc } = await page.data.load();
 
+	// To switch back to sync mode, comment out the line above and uncomment below:
+	// const MDXContent = page.data.body;
+	// const toc = page.data.toc;
+
 	return (
 		<DocsPage toc={toc} full={page.data.full}>
 			<DocsTitle>{page.data.title}</DocsTitle>