[pull] source from graphql:source

.eslintrc.cjs

@@ -0,0 +1,101 @@
+/* eslint-env node */
+
+const CODE_EXT = "js,jsx,cjs,mjs,ts,tsx,cts,mts"
+const MARKDOWN_EXT = "md,mdx"
+
+module.exports = {
+  root: true,
+  plugins: ["@graphql-eslint", "mdx", "@typescript-eslint", "tailwindcss"],
+  overrides: [
+    {
+      files: [`**/*.{${CODE_EXT}}`],
+      extends: [
+        "eslint:recommended",
+        "plugin:@typescript-eslint/recommended",
+        "plugin:tailwindcss/recommended",
+        "prettier",
+      ],
+      rules: {
+        "tailwindcss/classnames-order": "off",
+        "@typescript-eslint/no-restricted-imports": [
+          "error",
+          {
+            paths: [
+              {
+                name: "next/image",
+                message: "Please use `next-image-export-optimizer` instead",
+                allowTypeImports: true,
+              },
+            ],
+          },
+        ],
+        "prefer-const": ["error", { destructuring: "all" }],
+        "prefer-rest-params": "off",
+        "@typescript-eslint/no-explicit-any": "off",
+        "@typescript-eslint/no-unused-vars": "off",
+        "@typescript-eslint/ban-ts-comment": "off",
+        "@typescript-eslint/no-var-requires": "off",
+        "@typescript-eslint/ban-types": "off",
+      },
+      settings: {
+        tailwindcss: {
+          whitelist: ["roboto-mono"],
+        },
+      },
+    },
+    {
+      files: [`**/*.{${MARKDOWN_EXT}}`],
+      parser: "eslint-mdx",
+      extends: ["plugin:mdx/recommended"],
+      processor: "mdx/remark",
+      parserOptions: {
+        ecmaVersion: 13,
+        sourceType: "module",
+      },
+      settings: {
+        "mdx/code-blocks": true,
+        "mdx/language-mapper": {
+          js: "espree",
+          graphql: "@graphql-eslint/parser",
+          ts: "@typescript-eslint/parser",
+          typescript: "@typescript-eslint/parser",
+        },
+      },
+      rules: {
+        "mdx/remark": "error",
+      },
+    },
+    {
+      files: ["**/*.graphql"],
+      parser: "@graphql-eslint/parser",
+      rules: {
+        "@graphql-eslint/no-syntax-errors": "error",
+        "@graphql-eslint/unique-operation-name": "error",
+        "@graphql-eslint/unique-fragment-name": "error",
+        "@graphql-eslint/no-anonymous-operations": "warn",
+        "@graphql-eslint/lone-anonymous-operation": "error",
+        "@graphql-eslint/no-duplicate-fields": "error",
+        "@graphql-eslint/no-unused-fragments": "warn",
+        "@graphql-eslint/no-duplicate-fragment-names": "error",
+        "@graphql-eslint/no-undefined-variables": "error",
+        "@graphql-eslint/unique-variable-names": "error",
+      },
+    },
+    {
+      files: [`**/*.{${CODE_EXT}}`, `**/*.{${MARKDOWN_EXT}}`],
+      parserOptions: {
+        plugins: ["graphql"],
+      },
+    },
+    {
+      files: [
+        `src/pages/blog/**/*.{${MARKDOWN_EXT}}`,
+        `src/code/**/*.{${MARKDOWN_EXT}}`,
+      ],
+      rules: {
+        // Disable `remark-lint-first-heading-level` since in blogs we don't want to enforce the first heading to be an `h1`
+        "mdx/remark": "off",
+      },
+    },
+  ],
+}

.github/ISSUE_TEMPLATE/bug-report.md

@@ -14,19 +14,19 @@ labels: bug
 
 <!-- Steps for how we can replicate your experience (numbered lists are best) -->
 
-### Expected Result 
+### Expected Result
 
 <!-- What did you expect to happen? -->
 
-### Actual Result 
+### Actual Result
 
 <!-- What actually happened? -->
 
 ### Additional Context
 
-<!-- 
+<!--
     Anything else that will help us better understand, for example:
       * Information about your local environment
       * Screenshots
       * Code snippets
--->
+-->

.github/ISSUE_TEMPLATE/code-changes.md

@@ -20,4 +20,4 @@ labels: enhancement
 
 ### Additional Context
 
-<!-- Anything else that will help us understand your vision -->
+<!-- Anything else that will help us understand your vision -->

.github/PULL_REQUEST_TEMPLATE.md

@@ -1,15 +1,15 @@
 <!--
-  Thanks for making a pull request! 
-  
+  Thanks for making a pull request!
+
   Before submitting, please read our contributing guidelines:
   https://github.com/graphql/graphql.github.io/blob/source/CONTRIBUTING.md
 
-  Have any questions? 
+  Have any questions?
   Feel free to ask in this PR or you can also find us on the #website channel on the GraphQL Slack (invite link available in CONTRIBUTING.md)
 -->
 
 Closes #<issue number>
 
 ## Description
 
-<!-- Write a brief description of the changes introduced by this PR -->
+<!-- Write a brief description of the changes introduced by this PR -->

.github/workflows/docs-validation.yml

@@ -0,0 +1,64 @@
+# Docs validation workflow runs on each PR on main w/ broken link checker
+# and code snippet validation
+
+name: Docs validation
+
+on:
+  pull_request:
+    branches:
+      - main
+  push:
+    branches:
+      - main
+
+jobs:
+link-check:
+  name: Broken link checker
+  runs-on: ubuntu-latest
+
+  steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+
+    - name: Set up Node.js
+      uses: actions/setup-node@v4
+      with:
+        node-version: "20"
+        cache: "pnpm"
+
+    - name: Install dependencies
+      run: pnpm install --frozen-lockfile
+
+    - name: Build static site
+      run: pnpm build
+
+    - name: Set up Rust
+      uses: actions-rs/toolchain@v1
+      with:
+        toolchain: stable
+
+    - name: Install lychee
+      run: cargo install lychee
+
+    - name: Check links
+      run: lychee --verbose --no-progress './out/**/*.html'
+
+code-validate:
+  name: Code snippet and GraphQL validation
+  runs-on: ubuntu-latest
+  steps:
+    - uses: actions/checkout@v4
+
+    - uses: actions/setup-node@v4
+      with:
+        node-version: "20"
+        cache: "pnpm"
+
+    - name: Install dependencies
+      run: pnpm install --frozen-lockfile
+
+    - name: Run validation w/ annotations
+      run: pnpm lint:docs:ci
+
+    - name: Validate code snippets
+      run: pnpm validate:snippets

.github/workflows/prettier.yml

@@ -0,0 +1,20 @@
+name: Prettier Check
+
+on: pull_request
+
+jobs:
+  prettier-check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: the-guild-org/shared-config/setup@main
+        name: setup env
+        with:
+          packageManager: pnpm
+          workingDirectory: ./
+
+      - name: Install Dependencies
+        run: pnpm i
+      - name: Run Prettier Check
+        run: pnpm format:check

.gitignore

@@ -5,7 +5,6 @@ npm-debug.log*
 yarn-debug.log*
 yarn-error.log*
 
-old
 # Runtime data
 pids
 *.pid
@@ -21,21 +20,11 @@ coverage
 # nyc test coverage
 .nyc_output
 
-# Grunt intermediate storage (http://gruntjs.com/creating-plugins#storing-task-files)
-.grunt
-
-# Bower dependency directory (https://bower.io/)
-bower_components
-
-# node-waf configuration
-.lock-wscript
-
 # Compiled binary addons (http://nodejs.org/api/addons.html)
 build/Release
 
 # Dependency directories
 node_modules/
-jspm_packages/
 
 # Typescript v1 declaration files
 typings/
@@ -55,19 +44,20 @@ typings/
 # dotenv environment variable files
 .env*
 
-# gatsby files
-.cache/
-public
+!static/img/__og-image/**
+static/img/__og-image/*
+!static/img/__og-image/**/*.png
 
 # Mac files
 .DS_Store
 
-# Yarn
-yarn-error.log
-.pnp/
-.pnp.js
-# Yarn Integrity file
-.yarn-integrity
-
 # Swap files
 *.swp
+
+# Codegen stuff
+src/__generated__/
+
+.idea/
+.next/
+public/sitemap.xml
+out/

.node-version

@@ -0,0 +1 @@
+22.12.0

.npmrc

@@ -0,0 +1 @@
+enable-pre-post-scripts=true

.prettierignore

@@ -1,4 +1,7 @@
-.cache
-package.json
-package-lock.json
-public
+public/
+pnpm-lock.yaml
+*.mdx
+!src/pages/blog/2024-04-11-announcing-new-graphql-website/index.mdx
+!src/pages/blog/2024-08-15-graphql-local-initiative.mdx
+!src/pages/community/foundation/community-grant.mdx
+*.jpg

.prettierrc

@@ -1,4 +1,22 @@
 {
   "arrowParens": "avoid",
-  "semi": false
+  "semi": false,
+  "singleQuote": false,
+  "useTabs": false,
+  "tabWidth": 2,
+  "overrides": [
+    {
+      "files": "*.svg",
+      "options": { "parser": "html" }
+    },
+    {
+      "files": "*.mdx",
+      "options": {
+        "proseWrap": "always",
+        "semi": false,
+        "trailingComma": "none"
+      }
+    }
+  ],
+  "plugins": ["prettier-plugin-pkg", "prettier-plugin-tailwindcss"]
 }

.remarkrc.js

@@ -0,0 +1,7 @@
+export default {
+  plugins: [
+    "frontmatter", // Required to parse frontmatter for linting
+    "remark-lint-first-heading-level",
+    "remark-lint-heading-increment",
+  ],
+}

.vscode/settings.json

@@ -0,0 +1,12 @@
+{
+  "eslint.format.enable": true,
+  "editor.formatOnSave": true,
+  "editor.defaultFormatter": "esbenp.prettier-vscode",
+  "yaml.schemas": {
+    "https://json.schemastore.org/github-workflow.json": ".github/workflows/**/*.yml"
+  },
+  "typescript.tsdk": "node_modules/typescript/lib",
+  "[typescript]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  }
+}