Webhooks get a docs page with a live card preview (GRYT-1187)

.github/workflows/ci.yml

@@ -22,6 +22,10 @@ jobs:
       # to be swept, and that list only ever shrinks.
       - run: yarn test:comment-length
 
+      # The Webhooks page reads server main's openapi/webhooks.json, and its preview
+      # mirrors the payload rules. This fails when either drifts from the server.
+      - run: yarn test:webhook-spec
+
       # `next build` type-checks as part of building and there is no separate
       # typecheck script, so this is both.
       - run: yarn build

content/docs/build/index.mdx

@@ -4,7 +4,7 @@ description: Bots, addons, plugins, and the packages you can build against
 icon: Blocks
 ---
 
-Four ways to extend Gryt, and they run in different places. Which one you want
+Five ways to extend Gryt, and they run in different places. Which one you want
 depends on where your code needs to live.
 
 ## Pick where your code runs
@@ -25,6 +25,11 @@ depends on where your code needs to live.
     description="Runs in the server, sees messages and members"
     href="/docs/build/server-plugins"
   />
+  <Card
+    title="A webhook"
+    description="One HTTP request, and a message shows up in a channel"
+    href="/docs/build/webhooks"
+  />
   <Card
     title="Both halves"
     description="A server plugin and a client addon that talk to each other"

content/docs/build/meta.json

@@ -9,9 +9,10 @@
     "server-plugins",
     "server-plugin-api",
     "plugin-pairs",
-    "---Bots---",
+    "---Bots and webhooks---",
     "bots",
     "bot-api",
+    "webhooks",
     "---The server's own API---",
     "server-api",
     "---Voice SDK---",

content/docs/build/server-api.mdx

@@ -139,6 +139,8 @@ browser isn't the thing talking to BetterTTV or emoji.gg.
 
 ### Webhooks
 
+The payload, its limits and its errors are on [Webhooks](/docs/build/webhooks).
+
 | Method | Path | Auth | Notes |
 |--------|------|------|-------|
 | POST | `/api/webhooks/:webhookId/:token` | Token in the path | Post as the webhook |