Documentation Revamp

Co-authored-by: jbdoumenjou <jb.doumenjou@gmail.com>

docs/scripts/lint.sh

@@ -0,0 +1,16 @@
+#!/bin/sh
+# This script will run a couple of linter on the documentation
+
+set -eu
+
+# We want to run all linters before returning success (exit 0) or failure (exit 1)
+# So this variable holds the global exit code
+EXIT_CODE=0
+readonly BASE_DIR=/app
+
+echo "== Linting Markdown"
+# Uses the file ".markdownlint.json" for setup
+cd "${BASE_DIR}" || exit 1
+markdownlint --config ${BASE_DIR}/content/includes/.markdownlint.json "${BASE_DIR}/content/**/*.md" || EXIT_CODE=1
+
+exit "${EXIT_CODE}"