docs: rework documentation

.github/workflows/docs.yml

@@ -0,0 +1,72 @@
+name: Deploy mdbook documentation
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  workflow_dispatch:
+
+jobs:
+  changes:
+    runs-on: ubuntu-22.04
+    timeout-minutes: 10
+    outputs:
+      dirs: ${{ steps.filter.outputs.changes }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dorny/paths-filter@v3
+        id: filter
+        with:
+          filters: |
+            docs: docs/**
+
+  deploy:
+    needs: [changes]
+    if: ${{ !contains(needs.changes.outputs.dirs, '[]') }}
+    runs-on: ubuntu-22.04
+    timeout-minutes: 10
+    concurrency:
+      group: ${{ github.workflow }}-${{ github.ref }}
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install latest mdbook
+        run: |
+          tag=$(curl 'https://api.github.com/repos/rust-lang/mdbook/releases/latest' | jq -r '.tag_name')
+          url="https://github.com/rust-lang/mdbook/releases/download/${tag}/mdbook-${tag}-x86_64-unknown-linux-gnu.tar.gz"
+          mkdir mdbook
+          curl -sSL $url | tar -xz --directory=./mdbook
+          echo `pwd`/mdbook >> $GITHUB_PATH
+
+      - name: Build mdbook
+        working-directory: ./docs
+        run: mdbook build
+
+      - name: Deploy
+        uses: peaceiris/actions-gh-pages@v4
+        if: ${{ github.ref == 'refs/heads/main' }}
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./docs/book
+          keep_files: true
+
+  link_check:
+    name: verify-doc-links
+    needs: [deploy]
+    if: ${{ github.ref == 'refs/heads/main' }}
+    permissions:
+      contents: read
+      issues: write
+    timeout-minutes: 15
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Link Checker
+        id: lychee
+        uses: lycheeverse/lychee-action@v2
+        with:
+          args: ./docs --exclude-all-private --verbose
+          fail: false

.github/workflows/main.yml

@@ -5,6 +5,9 @@ on:
     branches: [main]
   pull_request:
     branches: [main]
+    paths-ignore:
+      - '*.md'
+      - 'docs/**'
 defaults:
   run:
     shell: bash

ADOPTERS.md

@@ -1,10 +1,10 @@
 # StarlingMonkey Adopters
 
-_If you are using StarlingMonkey in production at your organization, please add your company name to this list.
-The list is in alphabetical order._
+_If you are using StarlingMonkey in production at your organization, please add your company name to
+this list. The list is in alphabetical order._
 
-| Organization | Contact | Status | Description of Use |
-| - | - | - | - |
-| [Fastly](https://www.fastly.com) | [@guybedford](https://github.com/guybedford) | ![production](https://img.shields.io/badge/-production-blue?style=flat) | Fastly's [JS SDK](https://github.com/fastly/js-compute-runtime) for Compute at edge is powered by StarlingMonkey. |
+| Organization                        | Contact                                            | Status                                                                  | Description of Use                                                                                                                                              |
+| ----------------------------------- | -------------------------------------------------- | ----------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [Fastly](https://www.fastly.com)    | [@guybedford](https://github.com/guybedford)       | ![production](https://img.shields.io/badge/-production-blue?style=flat) | Fastly's [JS SDK](https://github.com/fastly/js-compute-runtime) for Compute at edge is powered by StarlingMonkey.                                               |
 | [Fermyon](https://www.fermyon.com/) | [@tschneidereit](https://github.com/tschneidereit) | ![production](https://img.shields.io/badge/-production-blue?style=flat) | [Fermyon Spin](https://www.fermyon.com/spin) supports serverless Wasm apps, using StarlingMonkey for its [Spin JS SDK](https://github.com/fermyon/spin-js-sdk). |
-| [Riza](https://riza.io/) | [@kyleconroy](https://github.com/kyleconroy) | ![production](https://img.shields.io/badge/-production-blue?style=flat) | The [Riza Code Interpreter API](https://docs.riza.io) relies on StarlingMonkey for isolated JavaScript execution. |
+| [Riza](https://riza.io/)            | [@kyleconroy](https://github.com/kyleconroy)       | ![production](https://img.shields.io/badge/-production-blue?style=flat) | The [Riza Code Interpreter API](https://docs.riza.io) relies on StarlingMonkey for isolated JavaScript execution.                                               |

AUTHORS.md

@@ -1,3 +1,5 @@
-The portions of this code found in the initial commit are Copyright © 2021-2023 Fastly Inc. and contributors to Fastly's [js-compute-runtime project](https://github.com/fastly/js-compute-runtime/).
+The portions of this code found in the initial commit are Copyright © 2021-2023 Fastly Inc. and
+contributors to Fastly's
+[js-compute-runtime project](https://github.com/fastly/js-compute-runtime/).
 
 Changes following that initial commit are Copyright © the respective contributors.