Skip to content

docs: prioritize idiomatic TypeSpec in lintdiff migrations - #5447

Merged
Yuchao Yan (msyyc) merged 3 commits into
Azure:feature/lintdiff-migration-newfrom
msyyc:msyyc-lintdiff-policy-guidance
Sep 10, 2026
Merged

docs: prioritize idiomatic TypeSpec in lintdiff migrations#5447
Yuchao Yan (msyyc) merged 3 commits into
Azure:feature/lintdiff-migration-newfrom
msyyc:msyyc-lintdiff-policy-guidance

Conversation

@msyyc

Copy link
Copy Markdown
Member

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.

  • Update the develop-lintdiff-rule skill's implementation boundary, evidence gate, fixture requirements, migration reporting, and review guidance. Added complexity must have tests demonstrating value for valid supported TypeSpec; otherwise omit it and document intentional parity gaps.
  • Update ParametersSchemaAsTypeObject/migration.md to preserve historical corpus numbers and evidence while labeling exact-emission parity as historical, not the promotion acceptance criterion. State the promoted use-model-request-body contract: a plain model without an indexer, with absent/synthetic void and multipart exemptions.

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.

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>
@msyyc
Yuchao Yan (msyyc) merged commit 5aea513 into Azure:feature/lintdiff-migration-new Sep 10, 2026
2 checks passed
@msyyc
Yuchao Yan (msyyc) deleted the msyyc-lintdiff-policy-guidance branch September 10, 2026 01:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant