Disallow YAML comments in API History

[piotrpdev]

As discussed in a Slack call and mentioned in https://github.com/piotrpdev/electron/commit/06cc0196c8a5970cd1ee3faade3c8fe49d745850, comments shouldn't be allowed in API History YAML.

Therefore, adding a check for them in the linter would be useful. You can probably just use a RegExp.

Most of them are already caught by checkStrings:

lint-roller/bin/lint-markdown-api-history.ts

Line 20 in e392dee

const possibleStringRegex = /^[ \S]+?: *?(\S[ \S]+?)$/gm;

lint-roller/bin/lint-markdown-api-history.ts

Lines 201 to 238 in e392dee

	// Special chars in YAML strings may break the parser if not surrounded by quotes,
	// including just causing the parser to read a value as null instead of throwing an error
	// <https://stackoverflow.com/questions/19109912/yaml-do-i-need-quotes-for-strings-in-yaml>
	if (checkStrings) {
	const possibleStrings = codeBlock.value.matchAll(possibleStringRegex);
	for (const [matchedLine, matchedGroup] of possibleStrings) {
	const trimmedMatchedGroup = matchedGroup.trim();
	const isMatchedGroupInsideQuotes =
	(trimmedMatchedGroup.startsWith('"') && trimmedMatchedGroup.endsWith('"')) ||
	(trimmedMatchedGroup.startsWith("'") && trimmedMatchedGroup.endsWith("'"));
	// Most special characters won't cause a problem if they're inside quotes
	if (isMatchedGroupInsideQuotes) continue;
	// I've only seen errors occur when the first or last character is a special character - @piotrpdev
	const isFirstCharNonAlphaNumeric =
	trimmedMatchedGroup[0].match(nonAlphaNumericDotRegex) !== null;
	const isLastCharNonAlphaNumeric =
	trimmedMatchedGroup.at(-1)?.match(nonAlphaNumericDotRegex) !== null;
	if (isFirstCharNonAlphaNumeric || isLastCharNonAlphaNumeric) {
	console.warn(
	'Warning occurred while parsing Markdown document:\n\n' +
	`'${filepath}'\n\n` +
	'Possible string value starts/ends with a non-alphanumeric character.\n\n' +
	'This might cause issues when parsing the YAML (might not throw an error)\n\n' +
	'Matched group:\n\n' +
	`${matchedGroup}\n\n` +
	'Matched line:\n\n' +
	`${matchedLine}\n\n` +
	'API history block:\n\n' +
	`${possibleHistoryBlock.value}\n`,
	);
	// Not throwing an error because it might be a false positive or desired behavior
	warningCounter++;
	}
	}
	}

But a line comment is not caught:

<!--
```YAML history
added:
  # This comment is not caught
  - pr-url: https://github.com/electron/electron/pull/22533
```
-->

[continuous-auth]

🎉 This issue has been resolved in version 2.4.0 🎉

The release is available on:

• npm package (@latest dist-tag)
• GitHub release

Your semantic-release bot 📦🚀