Scalar constructor/initalizer naming inconsitency

[timotheeguerin]

Doc talks about initializer https://typespec.io/docs/language-basics/scalars/#scalar-initializers
But the types are ScalarConstructor

[github-actions]

🎯 Issue Triage

The documentation refers to "scalar initializers" but the compiler JS API uses ScalarConstructor — these two names are inconsistent and could confuse users navigating between the docs and the API reference.

Category: Docs

Area: compiler:core

🔍 Analysis

• Docs terminology: scalar-initializers — used in [language basics docs]((typespec.io/redacted)
• API terminology: ScalarConstructor — the interface name in the JS API ([reference]((typespec.io/redacted)
• The fix is either: rename the API type to ScalarInitializer, or update the docs to use "constructor" — whichever term the team wants to standardize on.
• This is a relatively small inconsistency but can be confusing when cross-referencing the docs and the programmatic API.

📝 Suggested next steps

• Decide on the canonical term: "initializer" (doc-first) or "constructor" (API-first)
• If renaming the API type (ScalarConstructor → ScalarInitializer), this is a breaking change — add a breaking-change label and deprecation path
• Update docs and API references to use the chosen term consistently

Generated by Agentic Triage