Fix list capitalization rule to skip site-policy directory (#56129)

Author: heiskr

src/content-linter/lib/linting-rules/list-first-word-capitalization.js

@@ -5,6 +5,9 @@ export const listFirstWordCapitalization = {
   description: 'First word of list item should be capitalized',
   tags: ['ul', 'ol'],
   function: (params, onError) => {
+    // Skip site-policy directory as these are legal documents with specific formatting requirements
+    if (params.name && params.name.includes('content/site-policy/')) return
+
     // We're going to look for a sequence of 3 tokens. If the markdown
     // is a really small string, it might not even have that many tokens
     // in it. Can bail early.

src/content-linter/tests/unit/list-first-word-captitalization.js

@@ -76,4 +76,25 @@ describe(listFirstWordCapitalization.names.join(' - '), () => {
     const errors = result.markdown
     expect(errors.length).toBe(0)
   })
+
+  test('skips site-policy directory files', async () => {
+    const markdown = [
+      '- list item should normally be flagged',
+      '- another uncapitalized item',
+      '- a. this is alphabetic numbering',
+      '- b. this is also alphabetic numbering',
+    ].join('\n')
+
+    // Test normal behavior (should flag errors)
+    const normalResult = await runRule(listFirstWordCapitalization, { strings: { markdown } })
+    expect(normalResult.markdown.length).toBeGreaterThan(0)
+
+    // Test site-policy exclusion (should skip all errors)
+    const sitePolicyResult = await runRule(listFirstWordCapitalization, {
+      strings: {
+        'content/site-policy/some-policy.md': markdown,
+      },
+    })
+    expect(sitePolicyResult['content/site-policy/some-policy.md'].length).toBe(0)
+  })
 })