Borrowed some good linting bits from Nexodus

Signed-off-by: Anil Kumar Vishnoi <[email protected]>

Author: vishnoianil

Diff for: .github/workflows/lint-jobs.yml

@@ -0,0 +1,25 @@
+name: linters
+
+on:
+  push:
+    branches: ["main"]
+    paths:
+      - '**/*.md'
+  pull_request:
+    branches: ["main"]
+    paths:
+      - '**/*.md'
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  markdown-lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: markdownlint-cli2-action
+        uses: DavidAnson/markdownlint-cli2-action@v15
+        with:
+          globs: '**/*.md'

Diff for: .markdownlint-cli2.yaml

@@ -0,0 +1,13 @@
+config:
+  line-length: false
+  no-emphasis-as-header: false
+  first-line-heading: false
+  code-block-style: false
+  no-duplicate-header: false
+  single-trailing-newline: false
+globs:
+ - "**/*.md"
+ignores:
+ - "pkg"
+ - "**/node_modules/*"
+ - "**/node_modules/**"

Diff for: CODE_OF_CONDUCT.md

@@ -67,7 +67,7 @@ members of the project's leadership.
 
 ## Attribution
 
-This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
-available at https://www.contributor-covenant.org/version/1/4/code-of-conduct.html
+This [Code of Conduct](https://www.contributor-covenant.org/version/1/4/code-of-conduct.html)
+is adapted from the [Contributor Covenant][homepage], version 1.4.
 
 [homepage]: https://www.contributor-covenant.org

Diff for: Makefile

@@ -0,0 +1,20 @@
+.PHONY: help
+help:
+	@awk 'BEGIN {FS = ":.*##"; printf "\nUsage:\n  make \033[36m<target>\033[0m\n"} /^[a-zA-Z_0-9-]+:.*?##/ { printf "  \033[36m%-18s\033[0m %s\n", $$1, $$2 } /^##@/ { printf "\n\033[1m%s\033[0m\n", substr($$0, 5) } ' $(MAKEFILE_LIST)
+
+#
+# If you want to see the full commands, run:
+#   NOISY_BUILD=y make
+#
+ifeq ($(NOISY_BUILD),)
+    ECHO_PREFIX=@
+    CMD_PREFIX=@
+else
+    ECHO_PREFIX=@\#
+    CMD_PREFIX=
+endif
+
+.PHONY: md-lint
+md-lint: ## Lint markdown files
+	$(ECHO_PREFIX) printf "  %-12s ./...\n" "[MD LINT]"
+	$(CMD_PREFIX) docker run --rm -v $(CURDIR):/workdir docker.io/davidanson/markdownlint-cli2:v0.6.0 > /dev/null