Skip to content

[finding] getting-started/index.mdx advertises GraphQL via IGraphQLService — the contract does not exist and /graphql was removed from the dispatcher #10583

Description

@os-elon

Found by the docs audit of the first-run path (#10563).

What is wrong

content/docs/getting-started/index.mdx names a contract that no longer exists
and advertises a surface that was removed:

  • line 99 — "GraphQL + React Server Components ... (REST ships today; GraphQL is
    exposed via the IGraphQLService contract)"
  • line 133 — table row "Build CRUD APIs by hand | REST generated from schema
    (GraphQL via the IGraphQLService contract)"

IGraphQLService does not exist anywhere in packages/** on origin/main. It
survives only in CHANGELOG history (packages/runtime/CHANGELOG.md,
packages/spec/CHANGELOG.md, packages/services/service-realtime/CHANGELOG.md).

The capability went with it:

This lands on the second page of the first-run path, in the "Real-World Benefits"
table an evaluator reads.

Related occurrences (same defect family, in-scope pages)

// Expose via REST/GraphQL as the gloss on enable.apiEnabled, where the schema's
own .describe() says only "Expose object via automatic APIs":

  • content/docs/concepts/metadata-driven.mdx:474
  • content/docs/data-modeling/schema-design.mdx:65
  • content/docs/data-modeling/objects.mdx:82

Out of this card's scope, flagged for whoever fixes it

content/docs/api/index.mdx:19 carries the same stale claim (/graphql returns
501 unless an IGraphQLService implementation is registered). Not audited here —
content/docs/api/** was outside #10563's scope — but it belongs to the same fix.

Back-link: #10563

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions