ci(docs): lint the public documentation

Add the shared markdownlint configuration and a Docs workflow that lints the README and the top-level community documents. Long-form docs/ trees keep their own structure and are not linted.

Author: Michael Gasperini

.github/workflows/docs.yml

@@ -0,0 +1,29 @@
+name: Docs
+
+on:
+  push:
+    paths:
+      - "**/*.md"
+      - ".markdownlint-cli2.jsonc"
+      - ".github/workflows/docs.yml"
+  pull_request:
+    paths:
+      - "**/*.md"
+      - ".markdownlint-cli2.jsonc"
+      - ".github/workflows/docs.yml"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  markdownlint:
+    name: markdownlint
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+      - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
+        with:
+          node-version: 24
+      - run: npx --yes markdownlint-cli2@0.24.0 "README.md" "CONTRIBUTING.md" "SECURITY.md" "SUPPORT.md" "CODE_OF_CONDUCT.md"

.markdownlint-cli2.jsonc

@@ -0,0 +1,23 @@
+{
+  "config": {
+    "default": true,
+    "MD013": false,
+    "MD024": { "siblings_only": true },
+    "MD029": { "style": "ordered" },
+    "MD033": {
+      "allowed_elements": ["br", "details", "summary", "img", "p", "a", "div", "kbd", "sup", "sub", "table", "picture", "source"]
+    },
+    "MD034": false,
+    "MD041": true,
+    "MD060": false,
+    "MD046": { "style": "fenced" },
+    "MD048": { "style": "backtick" }
+  },
+  "ignores": [
+    "node_modules/**", ".git/**", "dist/**", "build/**", "coverage/**", "vendor/**",
+    "target/**", ".expo/**", "third_party/**", "third-party/**", "out/**", "bin/**",
+    "media/**", "assets/**", "CHANGELOG.md", "*.lock", "package-lock.json"
+  ]
+}
+
+