Add documentation website with GitHub Pages deployment (#145)

# TLDR;
Adds an Eleventy-based documentation website with automated GitHub Pages
deployment on every push.

# Details
- **GitHub Actions workflow** (`deploy-website.yml`) - Builds and
deploys the website to GitHub Pages on all pushes
- **Eleventy static site** - Documentation, blog, examples, and API
reference
- **Chinese translations** - Full i18n support for zh locale
- **Playwright tests** - Homepage, docs, blog, API, SEO, visual QA, and
syntax highlighting tests
- **API docs generator** - Script to auto-generate API documentation
from source

# How Do The Tests Prove The Changes Work?
The Playwright tests validate:
- All pages render correctly (homepage, docs, blog, examples)
- Navigation and links work
- Chinese translations load properly
- Syntax highlighting applies to code blocks
- SEO meta tags are present
- Visual elements display as expected

Author: MelbourneDeveloper

.config/dotnet-tools.json

@@ -17,7 +17,7 @@
       "rollForward": false
     },
     "dotnet-stryker": {
-      "version": "4.8.1",
+      "version": "4.11.0",
       "commands": [
         "dotnet-stryker"
       ],

.github/pull_request_template.md

@@ -1,5 +1,5 @@
 # TLDR;
 
-# Summary
-
 # Details
+
+# How Do The Tests Prove The Changes Work?

.github/workflows/deploy-website.yml

@@ -0,0 +1,56 @@
+name: Deploy Website to GitHub Pages
+
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: "npm"
+          cache-dependency-path: Website/package-lock.json
+
+      - name: Install dependencies
+        working-directory: Website
+        run: npm ci
+
+      - name: Build website
+        working-directory: Website
+        run: npm run build
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v5
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: Website/_site
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -15,3 +15,11 @@ coverage.cobertura.xml
 final-check/
 test-output-final
 nupkgs/
+
+# Website
+Website/node_modules/
+Website/_site/
+Website/package-lock.json
+Website/playwright-report/
+Website/test-results/
+Website/src/api/

CLAUDE.md

@@ -59,6 +59,12 @@ RestClient.Net is a functional HTTP client library using Result types for error
 
 5. **ProgressReportingHttpContent** - Custom `HttpContent` supporting upload/download progress callbacks.
 
+### PRs
+
+- Compare the current branch to main branch. Base title and comments solely on diff. IGNORE commit messages
+- Use the template at .github/pull_request_template.md
+- Keep the documentation tight.
+
 ### Code Generation
 
 **RestClient.Net.OpenApiGenerator** - Generates C# extension methods from OpenAPI 3.x specs:

Website/eleventy.config.js

@@ -0,0 +1,28 @@
+import techdoc from "eleventy-plugin-techdoc";
+
+export default function(eleventyConfig) {
+  eleventyConfig.addPlugin(techdoc, {
+    site: {
+      name: "RestClient.Net",
+      url: "https://restclient.net",
+      description: "The safest way to make REST calls in C#. Built with functional programming, type safety, and modern .NET patterns.",
+    },
+    features: {
+      blog: true,
+      docs: true,
+      darkMode: true,
+      i18n: true,
+    },
+    i18n: {
+      defaultLanguage: 'en',
+      languages: ['en', 'zh'],
+    },
+  });
+
+  eleventyConfig.addPassthroughCopy("src/assets");
+
+  return {
+    dir: { input: "src", output: "_site" },
+    markdownTemplateEngine: "njk",
+  };
+}

Website/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "restclient-net-website",
+  "version": "1.0.0",
+  "description": "RestClient.Net documentation website",
+  "type": "module",
+  "scripts": {
+    "generate-api": "node scripts/generate-api-docs.js",
+    "dev": "lsof -ti:8080 | xargs kill -9 2>/dev/null; npx @11ty/eleventy --serve --port=8080",
+    "build": "npm run generate-api && npx @11ty/eleventy",
+    "test": "playwright test"
+  },
+  "dependencies": {
+    "eleventy-plugin-techdoc": "^0.1.0"
+  },
+  "devDependencies": {
+    "@11ty/eleventy": "^3.1.2",
+    "@playwright/test": "^1.40.0"
+  }
+}

Website/playwright.config.js

@@ -0,0 +1,20 @@
+import { defineConfig } from '@playwright/test';
+
+export default defineConfig({
+  testDir: './tests',
+  fullyParallel: true,
+  forbidOnly: !!process.env.CI,
+  retries: process.env.CI ? 2 : 0,
+  workers: process.env.CI ? 1 : undefined,
+  reporter: 'list',
+  use: {
+    baseURL: 'http://localhost:8080',
+    trace: 'on-first-retry',
+  },
+  webServer: {
+    command: 'npx @11ty/eleventy --serve --port=8080',
+    url: 'http://localhost:8080',
+    reuseExistingServer: !process.env.CI,
+    timeout: 120000,
+  },
+});