Add website

.github/workflows/pages.yml

@@ -0,0 +1,57 @@
+name: Deploy Pages
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  build:
+    name: Build site
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v5
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: "24"
+          cache: "npm"
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build GAP website
+        run: npm run build
+
+      - name: Configure Pages
+        uses: actions/configure-pages@v6
+
+      - name: Upload Pages artifact
+        uses: actions/upload-pages-artifact@v5
+        with:
+          path: _site
+
+  deploy:
+    name: Deploy site
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v5

.gitignore

@@ -1 +1,2 @@
 node_modules/
+_site/

CONTRIBUTING.md

@@ -51,6 +51,7 @@ Required fields:
 ```yml
 id: <the PR number, or 0 if not yet known>
 title: <title>
+summary: <one sentence plain-text summary>
 # GAPs are never "strawman". Later we'll probably add additional statuses. If in
 # doubt, choose "proposal"
 status: proposal | draft | accepted
@@ -61,6 +62,9 @@ sponsor: "@githubUername"
 # of this GAP occurs. Otherwise, this can be set to the URL of the PR in which
 # the GAP was submited.
 discussion: "https://github.com/graphql/graphql-wg/issues/..."
+summary: >
+  A short summary (one or two sentences) of the GAP. Will be displayed on the
+  GAPs directory website.
 ```
 
 Additional optional fields:

README.md

@@ -28,6 +28,6 @@ Each proposal lives in its own `GAP-N` folder and must include:
 - `DRAFT.md` — the working document of the proposal/specification
 - `README.md` — a brief overview and status, including challenges/drawbacks and
   related resources or prior art
-- `metadata.yml` — authorship, sponsorship, status, and related metadata
+- `metadata.yml` — summary, authorship, sponsorship, status, and related metadata
 
 See [CONTRIBUTING.md](./CONTRIBUTING.md) for the full GAP process.

metadata.schema.json

@@ -5,6 +5,7 @@
   "type": "object",
   "properties": {
     "title": { "type": "string" },
+    "summary": { "type": "string" },
     "status": { "type": "string", "enum": ["proposal", "draft", "accepted"] },
     "authors": { "type": "array", "items": { "type": "string" } },
     "sponsor": { "type": "string" },
@@ -15,6 +16,14 @@
     "supersededBy": { "type": "integer" },
     "tags": { "type": "array", "items": { "type": "string" } }
   },
-  "required": ["id", "title", "status", "authors", "sponsor", "discussion"],
+  "required": [
+    "id",
+    "title",
+    "summary",
+    "status",
+    "authors",
+    "sponsor",
+    "discussion"
+  ],
   "additionalProperties": false
 }