docs: genericize custom labels and add notes

quartz.config.ts

@@ -8,7 +8,7 @@ import * as Plugin from "./quartz/plugins"
  */
 const config: QuartzConfig = {
   configuration: {
-    pageTitle: "Lest I Forget",
+    pageTitle: "TITLE", // Site title shown in the sidebar header and browser metadata
     pageTitleSuffix: "",
     enableSPA: true,
     enablePopovers: true,
@@ -16,41 +16,41 @@ const config: QuartzConfig = {
       provider: "plausible",
     },
     locale: "en-US",
-    baseUrl: "quartz.jzhao.xyz",
+    baseUrl: "YOUR-DOMAIN.com", // Canonical deployed domain used for OG images, RSS, and sitemap URLs
     ignorePatterns: ["private", "templates", ".obsidian"],
     defaultDateType: "modified",
     theme: {
       fontOrigin: "googleFonts",
       cdnCaching: true,
       typography: {
-        title: "Playfair Display",
-        header: "Anonymous Pro",
-        body: "JetBrains Mono",
-        meta: "Caveat",
-        code: "JetBrains Mono",
+        title: "Playfair Display", // Sidebar site title font
+        header: "Anonymous Pro", // Headings and explorer labels
+        body: "JetBrains Mono", // Main prose font
+        meta: "Caveat", // Metadata and small UI labels
+        code: "JetBrains Mono", // Inline code and code blocks
       },
       colors: {
         lightMode: {
-          light: "#E0E1DA",
-          lightgray: "#afb0a9",
-          gray: "#80817a",
-          darkgray: "#353630",
-          dark: "#171717",
-          secondary: "#2F3026",
-          tertiary: "#91a29c",
-          highlight: "rgba(143, 159, 169, 0.15)",
-          textHighlight: "#fff23688",
+          light: "#E0E1DA", // Page background
+          lightgray: "#afb0a9", // Borders and separators
+          gray: "#80817a", // Muted UI text
+          darkgray: "#353630", // Body text
+          dark: "#171717", // Strong headings and icons
+          secondary: "#2F3026", // Primary link color
+          tertiary: "#91a29c", // Hover/active accent
+          highlight: "rgba(143, 159, 169, 0.15)", // Internal link and code-line highlight
+          textHighlight: "#fff23688", // ==highlighted text==
         },
         darkMode: {
-          light: "#111516",
-          lightgray: "#7E7E7E",
-          gray: "#7D7D7D",
-          darkgray: "#CACACA",
-          dark: "#D0D0D0",
-          secondary: "#fff",
-          tertiary: "#CACACA",
-          highlight: "#313B4A",
-          textHighlight: "#313B4A",
+          light: "#111516", // Page background
+          lightgray: "#7E7E7E", // Borders and separators
+          gray: "#7D7D7D", // Muted UI text
+          darkgray: "#CACACA", // Body text
+          dark: "#D0D0D0", // Strong headings and icons
+          secondary: "#fff", // Primary link color
+          tertiary: "#CACACA", // Hover/active accent
+          highlight: "#313B4A", // Internal link and code-line highlight
+          textHighlight: "#313B4A", // ==highlighted text==
         },
       },
     },
@@ -91,9 +91,9 @@ const config: QuartzConfig = {
       Plugin.Static(),
       Plugin.Favicon(),
       Plugin.NotFoundPage(),
-      // Comment out CustomOgImages to speed up build time
+      // Comment out CustomOgImages to speed up build time.
       Plugin.CustomOgImages({
-        colorScheme: "darkMode",
+        colorScheme: "darkMode", // Use the dark palette when generating social cards
       }),
     ],
   },