update

Author: Adammatthiesen

.github/workflows/ci-link-validator.yml

@@ -21,3 +21,4 @@ jobs:
 
       - name: Run Link Check
         run: pnpm ci:build
+        # Link validation errors will cause the build to fail automatically

astro.config.mts

@@ -19,6 +19,7 @@ const linkValidator = process.env.CHECK_LINKS
 			starlightLinksValidator({
 				errorOnFallbackPages: false,
 				errorOnInconsistentLocale: true,
+				// Exclude TypeDoc paths as they contain auto-generated content with many internal links
 				exclude: ['/*/typedoc/**/*'],
 			}),
 		]

typedoc.config.ts

@@ -57,9 +57,11 @@ const tdMDX = createStarlightTypeDocPlugin()[0];
 // Set to true to enable testing mode for TypeDoc
 const testTypeDoc = false;
 
+// When CHECK_LINKS is set, we disable TypeDoc plugins (isProd becomes false)
+// to improve performance and prevent link validation errors in generated docs
 const isLinkCheck = !!process.env.CHECK_LINKS;
 
-const isProd = isLinkCheck === false && process.env.NODE_ENV === 'production';
+const isProd = !isLinkCheck && process.env.NODE_ENV === 'production';
 
 const TypeDocPlugins = (isProd: boolean, testingMode: boolean): StarlightPlugin[] => {
 	if (isProd || testingMode) {