doc: validate urls

.github/workflows/ci.yml

@@ -1,5 +1,5 @@
 name: CI
-on: [push, pull_request]
+on: [ push, pull_request ]
 
 env:
   RUSTFLAGS: -Dwarnings
@@ -19,25 +19,30 @@ jobs:
           - nightly
     timeout-minutes: 45
     steps:
-      - uses: actions/checkout@v4
-      - uses: dtolnay/rust-toolchain@stable
+      -
+        uses: actions/checkout@v4
+      -
+        uses: dtolnay/rust-toolchain@stable
         with:
           toolchain: ${{ matrix.rust }}
           components: clippy, rustfmt
-      - run: cargo install cargo-hack --locked
-      - uses: taiki-e/install-action@nextest
-      - uses: actions/setup-node@v4
+      -
+        run: cargo install cargo-hack --locked
+      -
+        uses: taiki-e/install-action@nextest
+      -
+        uses: actions/setup-node@v4
         with:
           node-version: lts/Iron # 20
-      - uses: denoland/setup-deno@v1
+      -
+        uses: denoland/setup-deno@v1
         with:
           deno-version: v1.45.x
-      - uses: Swatinem/[email protected]
-      - run: npm install --global [email protected] [email protected]
-      - name: Install yj
-        run: |
-          curl -L https://github.com/sclevine/yj/releases/download/v5.1.0/yj-linux-amd64 -o yj
-          chmod +x yj
-          sudo mv yj /usr/local/bin/
-      - run: lefthook run --force pre-commit
-      - run: cargo hack test --feature-powerset
+      -
+        uses: Swatinem/[email protected]
+      -
+        run: ./install.sh
+      -
+        run: lefthook run --force pre-commit
+      -
+        run: cargo hack test --feature-powerset

.remarkrc.json

@@ -0,0 +1,6 @@
+{
+  "plugins": [
+    ["remark-validate-links", {}],
+    ["remark-lint-no-dead-urls", {}]
+  ]
+}

install.sh

@@ -0,0 +1,12 @@
+#!/usr/bin/env bash
+
+npm install --global \
+  [email protected] \
+  [email protected] \
+  [email protected] \
+  [email protected]
+
+# Install yj
+curl -L https://github.com/sclevine/yj/releases/download/v5.1.0/yj-linux-amd64 -o /tmp/yj
+chmod +x /tmp/yj
+sudo mv /tmp/yj /usr/local/bin/yj