Skip to content

Commit dacdea2

Browse files
Urigoclaude
andcommitted
Reduce website/ to the docs content and the config schema generator
The docs at the-guild.dev/graphql/codegen are now built and served by the-guild-org/website, which fetches this folder at build time. The Next.js/Nextra app that used to render them here is gone, and what remains is laid out as if it had been content-only from the start: website/ content/{docs,plugins,partials}/ MDX with meta.json ordering assets/ images referenced by pages icons/ plugin icons plugins.json plugin registry (title, npm, icon, tags) plugin-configs.json where each plugin's config type lives config.schema.json generated JSON Schema (committed) scripts/generate-config-schema.ts the generator package.json, tsconfig.json, README.md The Nextra conventions were applied to the MDX once: _meta.ts became meta.json plus sidebarTitle frontmatter, shim imports and component markers are gone, getStaticProps options became isDev/hasOperationsNote frontmatter, the leading H1 became the title, and code fences use title=. The plugin registry and config-type list are plain JSON instead of TypeScript modules with Next.js imports. Category comes from the page's folder; the drifted category-to-packages module is dropped. The schema generator resolves workspace packages through the root tsconfig paths, so it no longer needs the packages built first, and its output is byte-identical to the committed schema. Per-plugin Config API Reference docs are rendered by the website from the schema, so the markdown docs generator is gone too. The website package keeps only the external plugin packages whose typings the schema reads, plus the workspace ones it reads from source. Removed with the app: the Cloudflare Pages deploy workflow (the site is no longer deployed from here), the route-lockfile integrity check, the npm-info fetch (the website does that itself), fonts, components, the live demo, and the Next/Tailwind config. Editor schema path, ESLint overrides, .prettierignore and .gitignore entries follow. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
1 parent 83df06c commit dacdea2

238 files changed

Lines changed: 2612 additions & 12284 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.github/workflows/docs-preview.yaml‎

Lines changed: 1 addition & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -9,12 +9,7 @@ name: docs-preview
99
on:
1010
pull_request:
1111
paths:
12-
- website/src/pages/**
13-
- website/src/components/java-installation.mdx
14-
- website/src/lib/plugins/**
15-
- website/src/category-to-packages.mjs
16-
- website/public/assets/**
17-
- website/public/config.schema.json
12+
- website/**
1813

1914
jobs:
2015
request-preview:

‎.github/workflows/notify-website.yaml‎

Lines changed: 3 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,14 @@
11
name: notify-website
22

33
# The docs at the-guild.dev/graphql/codegen are built by
4-
# the-guild-org/website, which fetches this repo's website/src/pages content
5-
# at build time. Tell it to redeploy whenever that content changes.
4+
# the-guild-org/website, which fetches this repo's website/ folder at build
5+
# time. Tell it to redeploy whenever that content changes.
66
on:
77
push:
88
branches:
99
- master
1010
paths:
11-
- website/src/pages/**
12-
- website/src/components/java-installation.mdx
13-
- website/src/lib/plugins/**
14-
- website/src/category-to-packages.mjs
15-
- website/public/assets/**
16-
- website/public/config.schema.json
11+
- website/**
1712

1813
jobs:
1914
dispatch:

‎.github/workflows/website-integrity.yml‎

Lines changed: 0 additions & 59 deletions
This file was deleted.

‎.github/workflows/website.yml‎

Lines changed: 0 additions & 53 deletions
This file was deleted.

‎.gitignore‎

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -15,8 +15,6 @@ recompile.sh
1515

1616
.next/
1717
out/
18-
website/public/sitemap.xml
19-
website/public/_redirects
2018
.eslintcache
2119

2220
**/cypress/screenshots

‎.prettierignore‎

Lines changed: 6 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -11,21 +11,16 @@ pnpm-lock.yaml
1111

1212
# temporarily ignore follow files because prettier-ignore comments don't work in mdx2
1313
# see https://github.com/prettier/prettier/pull/12208
14-
website/src/pages/docs/advanced/generated-files-colocation.mdx
15-
website/src/pages/docs/advanced/how-does-it-work.mdx
16-
website/src/pages/docs/config-reference/schema-field.mdx
17-
website/src/pages/docs/getting-started/index.mdx
18-
website/src/pages/docs/guides/graphql-server-apollo-yoga.mdx
19-
website/src/pages/docs/guides/react.mdx
20-
website/src/pages/plugins/index.mdx
21-
website/src/pages/plugins/presets/near-operation-file-preset.mdx
14+
website/content/docs/advanced/generated-files-colocation.mdx
15+
website/content/docs/advanced/how-does-it-work.mdx
16+
website/content/docs/config-reference/schema-field.mdx
17+
website/content/docs/getting-started/index.mdx
18+
website/content/docs/guides/graphql-server-apollo-yoga.mdx
19+
website/content/plugins/presets/near-operation-file-preset.mdx
2220

2321
temp/
24-
website/out
25-
website/.next
2622

2723
# added because it blocks CI and when I try to format it locally nothing happens :)
28-
website/src/components/live-demo/LiveDemo.tsx
2924

3025
# This should be added bc our rust test setup for the SWC plugin does a string diff, and it fails
3126
# bc it compares imports with double quotes against the formatted perttier single quotes

‎.vscode/settings.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"yaml.schemas": {
3-
"./website/static/config.schema.json": "*codegen.*"
3+
"./website/config.schema.json": "*codegen.*"
44
},
55
"eslint.useFlatConfig": false,
66
"editor.tabSize": 2,

‎eslint.config.mjs‎

Lines changed: 0 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -50,7 +50,6 @@ const theGuildIndex = compat.config({
5050
'babel.config.js',
5151
'postcss.config.{js,cjs}',
5252
'rollup.config.js',
53-
'next-sitemap.config.js',
5453
],
5554
env: { node: true },
5655
},
@@ -141,13 +140,6 @@ export default [
141140
// Node environment for all files
142141
...compat.env({ node: true }),
143142

144-
// Website files: extend @theguild react config
145-
...compat
146-
.config({
147-
extends: ['./node_modules/@theguild/eslint-config/src/react.js'],
148-
})
149-
.map(config => ({ ...config, files: ['website/**'] })),
150-
151143
// Test files
152144
{
153145
files: [

‎packages/graphql-cli-codegen-plugin/README.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,5 +14,5 @@ The plugin `@graphql-cli/codegen` is deprecated, and no longer maintained.
1414
Please visit
1515
[Migrating from GraphQL-CLI to Inspector CLI](https://the-guild.dev/graphql/inspector/docs/migration-guides/from-graphql-cli)
1616
documentation to get more information about migration from `GraphQL-CLI` to `Inspector CLI` or visit
17-
[GraphQL-CLI documentation](../../website/src/pages/docs/guides/graphql-cli.mdx) in GraphQL Code
17+
[GraphQL-CLI documentation](../../website/content/docs/guides/graphql-cli.mdx) in GraphQL Code
1818
Generator.

0 commit comments

Comments
 (0)