Add the markdownlint tool (#265)

Add the tool so we can begin working on the lint issues.

Signed-off-by: Dean Roehrich <dean.roehrich@hpe.com>

Author: roehrich-hpe

.markdownlint.jsonc

@@ -0,0 +1,27 @@
+{
+  // Default state for all rules
+  "default": true,
+
+  // MD007/ul-indent Unordered list indentation
+  "MD007": {
+    // Spaces for indent
+    "indent": 4
+  },
+
+  // MD013/line-length - Line length
+  "MD013": {
+    // Number of characters
+    "line_length": 900,
+    // Number of characters for headings
+    "heading_line_length": 80,
+    // Number of characters for code blocks
+    "code_block_line_length": 500  // some example console output is wide
+  },
+
+  // MD046/code-block-style - Code block style
+  // Disable consistency checks between fenced/indented code blocks.
+  // Standard code blocks should use fences, while mkdocs admonitions require
+  // 4-space indented blocks.
+  "code-block-style": false
+}
+

Makefile

@@ -0,0 +1,10 @@
+# Runs a container that lints all markdown (.md) files in the project.
+# Uses the markdownlint-cli (https://github.com/igorshubovych/markdownlint-cli).
+# Rules for markdownlint package can be found here:
+# https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md
+markdownlint:
+	docker run --rm --name markdownlint \
+		--volume ${PWD}:/workdir \
+		ghcr.io/igorshubovych/markdownlint-cli:latest \
+		--config .markdownlint.jsonc --ignore venv "**/*.md"
+