Commit ff9912b
docs(api): stop documenting a
`content/docs/api/index.mdx` carried GraphQL as a behaviour contract, and both
halves of it were false. Re-derived at this base:
1. `IGraphQLService` exists nowhere in `packages/**/src` — the only survivors
repo-wide are three CHANGELOGs, `packages/spec/llms.txt:171`, and the doc
page itself.
2. The route is not mounted, so it cannot answer 501.
`packages/runtime/src/http-dispatcher.ts:2026` is the whole of it:
`// /graphql removed — GraphQL is not in the product plan (#2462 follow-on).`
There is no `createGraphQLDomain` beside the fifteen domains registered at
`http-dispatcher.ts:556-574`, and no `handleGraphQL` in the runtime at all.
Remove, do not rewrite. `packages/runtime/src/domains/unavailable.ts` is the
canonical statement of what the "absent capability" table's two rows are: 501
is "the route is there; the implementation is not — every domain mounted
unconditionally", 404 is "the route is not there". Every other entry in the
501 row (`/automation`, `/notifications`, `/ui/*`, `/ai/*`, `/auth/*`,
`/i18n/*`) has a domain module registered unconditionally; `/graphql` has
none, so it belongs in neither list. `content/docs/permissions/authorization.mdx:53`
already says so in prose — "`/graphql` now 404s".
A row reading "not available" would still tell a reader GraphQL was once a
surface worth listing on the API landing page, which is the false implication
itself. So the row goes.
Sites corrected:
- `api/index.mdx:19` — GraphQL row deleted from "Surfaces at a glance".
- `api/index.mdx:172` — `/graphql` dropped from the 501 example list.
- `api/index.mdx:28` — "REST and GraphQL are how code consumes your app" →
"REST is how code consumes your app". Same page, same false claim; leaving it
would have left the page contradicting its own surfaces table.
- `getting-started/quick-reference.mdx:135`, `data-modeling/fields.mdx:320` —
the two lower-severity residues the card names, same family.
Docs-only: `content/` sits outside every workspace package and `apps/docs`
is `private: true`, so this publishes nothing — skip-changeset.
Claude-Session: https://claude.ai/code/session_01DdCnBGcHeufjrq7drTD3wt
Co-authored-by: Claude <noreply@anthropic.com>/graphql route the dispatcher removed (#10828)1 parent ea1c7bf commit ff9912b
3 files changed
Lines changed: 4 additions & 5 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
16 | 16 | | |
17 | 17 | | |
18 | 18 | | |
19 | | - | |
20 | 19 | | |
21 | 20 | | |
22 | 21 | | |
| |||
25 | 24 | | |
26 | 25 | | |
27 | 26 | | |
28 | | - | |
| 27 | + | |
29 | 28 | | |
30 | 29 | | |
31 | 30 | | |
| |||
169 | 168 | | |
170 | 169 | | |
171 | 170 | | |
172 | | - | |
| 171 | + | |
173 | 172 | | |
174 | 173 | | |
175 | 174 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
317 | 317 | | |
318 | 318 | | |
319 | 319 | | |
320 | | - | |
| 320 | + | |
321 | 321 | | |
322 | 322 | | |
323 | 323 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
132 | 132 | | |
133 | 133 | | |
134 | 134 | | |
135 | | - | |
| 135 | + | |
136 | 136 | | |
137 | 137 | | |
138 | 138 | | |
| |||
0 commit comments