docs: align service naming on "Resolver" instead of "Pipeline" - #195
Merged
Conversation
The Pipeline service is now documented as "Resolver" (the guide already lives at /guides/resolver), but many pages still said "Pipeline" — most visibly the Core Concepts › Services entry, whose "Learn more about Pipeline →" link points at the Resolver guide. Rename the user-facing service name across getting-started, guides, tutorials, reference, the site description, and the nav ordering config. Also fixed along the way: - `navItemOrder.guides` in .vitepress/config/constants.ts still listed the removed `pipeline` guide instead of `resolver`, so the Resolver entry fell through to the default ordering. - The "Chaining Queries" card on /tutorials linked to a non-existent `pipelines` page; it now points at `resolver`. - Three `tailor.config.ts` samples used an `application.subgraphs` array containing `"pipeline"`. That key no longer exists in the SDK (services are declared as `db` / `resolver` / `auth` / …), so a plain rename would have left a sample that cannot work. They now match the shape documented in /sdk/configuration. - The Resolver guide's Overview described the legacy declarative step model, which the guide itself later says is replaced by the `body` function. Machine-readable identifiers keep the `pipeline` spelling, because that is what the platform actually accepts: - the `pipeline` TRN resource type and its examples in /reference/concepts/trn - the `pipeline.resolver.executed` event type and the `pipelines` key in its payload - the `CreatePipelineService` API method name Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
anukiransolur
approved these changes
Aug 5, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why
Core Concepts › Services has a Pipeline section whose "Learn more about Pipeline →" link goes to the Resolver guide. Since the direction is to standardize on Resolver, this PR sweeps the whole docs set for leftover
Pipelinenaming.What changed
Renamed the user-facing service name Pipeline → Resolver across:
getting-started/core-concepts/(services, platform-architecture, workspace-application)guides/(resolver, application, secretmanager, events, executor, function, workflow, tailordb)tutorials/index.mdreference/(terminology, timeouts, platform-limits, outgoing-ip-addresses, cel-scripting, js-scripting, api-references).vitepress/config.mtssite description,README.mdBugs found during the sweep
navItemOrder.guidesin.vitepress/config/constants.tsstill listed the removedpipelineguide instead ofresolver, so the Resolver entry fell through to default ordering./tutorialslinked to a non-existentpipelinespage → nowresolver.tailor.config.tssamples used anapplication.subgraphsarray containing"pipeline". That key no longer exists in the SDK (services are declared asdb/resolver/auth/ …), so a plain rename would have left a sample that cannot work. They now match the shape documented in /sdk/configuration.bodyfunction.Deliberately left as
pipelineThese are machine-readable identifiers the platform actually accepts — renaming them would make the docs wrong:
pipelineTRN resource type and its examples inreference/concepts/trn.mdpipeline.resolver.executedevent type and thepipelineskey in its payloadCreatePipelineServiceAPI method namepipelines, andtailor generatepipeline phases (unrelated senses)Needs a second opinion (not touched)
getting-started/console/overview.md,key-features.md) still sayPipelinebecause they describe literal Console UI labels ("select thePipelineoption") and the screenshots show it. These should be updated together with the Console UI — someone who can check the current Console should confirm. I did fix the link text onkey-features.mdline 33.sdk/services/resolver.mdhas a "Comparison with Tailor Platform Pipeline Resolver" section contrasting the SDK resolver against the legacy YAMLstepsmodel. Renaming it would make the comparison incoherent; it probably wants deleting or rewriting instead.sdk/cli/application.md— "IdP / TailorDB / Pipeline endpoints" refers to OperatorService endpoint grouping, which may still be named Pipeline server-side.getting-started/index.md— "visualize pipelines" describes a Console feature; left alone for the same reason as the Console pages.guides/static-website-hosting.mdstill uses the outdateddefineTailorConfig({ workspace, app: { subgraphs } })shape. Out of scope here — better handled by a full SDK sample sync.Verification
pnpm typecheck,pnpm lint,pnpm fmt:check, andpnpm buildall pass. The build resolves all internal links, so no dead links were introduced.🤖 Generated with Claude Code