docs: prioritize idiomatic TypeSpec in lintdiff migrations - #5447
Merged
Yuchao Yan (msyyc) merged 3 commits intoSep 10, 2026
Merged
Conversation
Record TypeSpec-first migration policy and preserve historical ParametersSchemaAsTypeObject parity evidence without treating emitter simulation as a promotion requirement. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Yuchao Yan (msyyc)
requested review from
Mark Cowlishaw (markcowl),
Timothee Guerin (timotheeguerin) and
Jeff Fisher (xirzec)
as code owners
September 10, 2026 01:01
Yuchao Yan (msyyc)
merged commit Sep 10, 2026
5aea513
into
Azure:feature/lintdiff-migration-new
2 checks passed
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.
Summary
Adopt the TypeSpec-first migration principle settled in #5361: native linter rules should validate idiomatic TypeSpec semantics, preserving Swagger parity only where it naturally maps to that contract. Exact executable Swagger behavior is not a requirement when it entails emitter/format/encoding simulation or handling constructs already invalidated by TypeSpec or Azure rules.
Scope
Independent documentation-only PR against
feature/lintdiff-migration-new. Contains exactly the skill and migration note; no production implementation, generated corpus data, or dependency changes. Markdown is excluded by the Chronus changedFiles configuration, so no release metadata is added.The existing corpus evidence remains historical; no new corpus run or broad repository build/test was performed for this documentation change.