add CI job for linting

.github/workflows/commonmark-lint.yaml

@@ -0,0 +1,25 @@
+name: "Contracts: Smoke test deployment"
+
+# This workflow is triggered from the main CI workflow.
+on:
+  workflow_call:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Check out the project
+      uses: actions/checkout@v4
+
+    - name: Lint all commonmark/markdown files
+      uses: DavidAnson/markdownlint-cli2-action@v19
+      continue-on-error: true
+      with:
+        fix: true
+        globs: '(scripts|crates)/**/README.md;contracts/**/*.md;specs/**/*.md;docs*/**/*.md'
+        separator: ';'
+
+    - name: Check compliance
+      run: |
+        git diff --exit-code

Makefile

@@ -5,8 +5,10 @@ default:
 	cd contracts && make gen
 	cd crates && (cargo build --release && ./target/release/ipc-cli --version && ./target/release/fendermint --version)
 
-# podman has a compatible API, and is better supported
+# Uses 'docker' as the default container runtime.
+# Can be overwritten to 'podman' for a compatible API and potentially enhanced support
 CONTAINER_FRONTEND_BIN ?= docker
+
 SUBTREES_RUST := $(patsubst %, crates/%, $(ls -1 crates))
 SUBTREES_CONTRACTS := contracts
 SUBTREES_ALL := $(SUBTREES_RUST) $(SUBTREES_CONTRACTS)