fix: enhance warning message for identical h1 and frontmatter titles to clarify redundancy

jliermann · jliermann · commit ca869a3ccb42 · 2026-01-30T13:59:10.000+01:00
diff --git a/scripts/validate-content.js b/scripts/validate-content.js
@@ -131,7 +131,7 @@ function validateTitle(filePath, frontmatter, content) {
     // If both present, they must not be identical
     if (h1Title && fmTitle) {
         if (h1Title === fmTitle) {
-            warnings.push(`h1 and frontmatter title are identical ("${h1Title}"). Should be different`);
+            warnings.push(`h1 and frontmatter title are identical ("${h1Title}") and thus redundant. Both fields should only be used if different strings are required for page and navigation titles.`);
         }
     }
 

Original file line number	Diff line number	Diff line change
`@@ -131,7 +131,7 @@ function validateTitle(filePath, frontmatter, content) {`
`131`	`131`	`// If both present, they must not be identical`
`132`	`132`	`if (h1Title && fmTitle) {`
`133`	`133`	`if (h1Title === fmTitle) {`
`134`		- warnings.push(`h1 and frontmatter title are identical ("${h1Title}"). Should be different`);
	`134`	+ warnings.push(`h1 and frontmatter title are identical ("${h1Title}") and thus redundant. Both fields should only be used if different strings are required for page and navigation titles.`);
`135`	`135`	`}`
`136`	`136`	`}`
`137`	`137`