Enforce filename standard with new linter rule

_linter/markdownlint.js

@@ -2,6 +2,10 @@ const markdownlint = require("markdownlint");
 const glob = require("glob");
 const fs = require('fs');
 const YAML = require('yaml');
+const ruleURLs = {
+  'hc': 'https://github.com/arduino/help-center-content/blob/main/_linter/markdownlint/Rules.md',
+  'md': 'https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md'
+};
 
 // Get markdown file paths
 let files = glob.sync('content/**/*.md');
@@ -14,9 +18,6 @@ const customRules = require('./markdownlint/rules/rules.js');
 const configJSON = fs.readFileSync('./_linter/markdownlint.yml', 'utf8')
 const configYAML = YAML.parse(configJSON);
 
-// treeify
-const treeify = require("treeify");
-
 const options = {
   "config": configYAML,
   "files": files,
@@ -93,8 +94,10 @@ markdownlint(options, function callback(err, result) {
           errorLines += getErrorMessage(error) + '\n';
 
           // make rule violation row
+          const anchor = error.ruleNames[0].toLowerCase();
+          const URL = ruleURLs[anchor.substring(0,2)];
           violatedRules.add(
-            error.ruleNames[0] + ': ' + error.ruleInformation
+            error.ruleNames[0] + ': ' + URL + '#' + anchor
           );
 
           errorCount++;

_linter/markdownlint.yml

@@ -28,3 +28,4 @@ HC005:
   - labels
 HC006:
   title_line_length: 124
+HC008: true

_linter/markdownlint/Rules.md

@@ -134,3 +134,22 @@ title: "Example title"
 
 ### Level 3 heading
 ```
+
+<a name="hc008"></a>
+
+## HC008 - Filename should match title
+
+Tags: filenames
+
+Aliases: filename-match
+
+Enforces a filename standard based on the article title.
+
+Starting with the article title, the filename is determined by following these steps:
+
+1. Remove all single quotes `'` and double quotes `"`
+2. Convert all sequences (1 or more) of non-alphanumeric characters to a single dash `-`
+3. Remove any leading or trailing dash `-`
+4. Append the `.md` extension
+
+Resolve the error by renaming the file to the expected filename.

_linter/markdownlint/rules/hc008.js

@@ -0,0 +1,37 @@
+// @ts-check
+
+"use strict";
+
+const markdownlintRulesDir = "../..//node_modules/markdownlint/lib/";
+const { addErrorDetailIf, filterTokens, frontMatterHasTitle } = require(markdownlintRulesDir + "../helpers");
+
+const path = require("path");
+
+module.exports = {
+  "names": [ "HC008", "filename-match" ],
+  "description": "Filename should match title",
+  "tags": [ "titles" ],
+  "function": function HC008(params, onError) {
+    const filename = path.basename(params.name);
+
+    const foundFrontMatterTitle =
+      frontMatterHasTitle(
+        params.frontMatterLines,
+        params.config.front_matter_title
+      );
+
+    if (foundFrontMatterTitle) {
+      const title = params.frontMatterLines.find(a =>a.includes("title: ")).substring(7);
+
+      const expectedFilename = title //sanitize(title)
+      .replace(/['"]+/g, '')
+      .replace(/[^A-Za-z0-9]+/g, '-')
+      .replace(/-$/, '') + '.md';
+      if (filename != expectedFilename) {
+        addErrorDetailIf(onError, 1,
+          filename, expectedFilename, null, "Expected: " + expectedFilename
+          + "; Actual: " + filename);
+        }
+    }
+  }
+};

_linter/markdownlint/rules/rules.js

@@ -12,7 +12,8 @@ const rules = [
   require("./hc004"),
   require("./hc005"),
   require("./hc006"),
-  require("./hc007")
+  require("./hc007"),
+  require("./hc008")
 ];
 
 rules.forEach((rule) => {