Skip to content

docs: standardize TCGC operation naming rule promotions - #5667

Merged
Yuchao Yan (msyyc) merged 1 commit into
feature/lintdiff-migration-newfrom
skill/promote-sdk-operation-naming
Oct 10, 2026
Merged

Yuchao Yan (msyyc) merged 1 commit into
feature/lintdiff-migration-newfrom
skill/promote-sdk-operation-naming

Conversation

@msyyc

Copy link
Copy Markdown
Member

Purpose

Make the TCGC operation-naming promotion pattern explicit for similar rules such as DeleteInOperationName, ListInOperationName, and PatchInOperationName, as requested. This independent, skill-only PR targets the current branch, feature/lintdiff-migration-new; it does not modify the rule promotion PRs or package code.

Evidence and change

PUT promotion #5457 established common SDK naming in TCGC. PATCH promotion #5665 initially used authored operation names in ARM and was corrected to the same TCGC pattern at the user's request. Its independently verified Balanced review reported zero findings on commit 5d131d487ec0e1dd8f1bd0b6ff1050fe4df2f747.

The promotion skill now gives this naming family an explicit, bounded adaptation contract: prefer TCGC, use non-mutating context creation and getLibraryName(..., AllScopes), honor common client/exact/friendly names, and ignore emitter-scoped names and OpenAPI operation IDs. Preserve rule-specific endpoint, verb, paging, prefix, severity, and diagnostic-target behavior; a list-only policy must not be replaced mechanically by a generic GET naming rule.

The instructions also require both-direction override regressions, appropriate opt-in audience handling, disabled client-sdk registration, native documentation and release metadata, and an explicit distinction between immutable authored-source evidence and adapted SDK-name behavior.

The review skill consumes that same authorized contract rather than incorrectly classifying the documented name-domain adaptation as an unfixed source defect. Other semantic changes retain the existing source-repair stop policy. No source changes, new diagnostics, auto-merge, or new retry permissions are authorized by this update.

Validation

Inspected the complete two-file skill diff, checked the new cross-skill anchor and existing references, and ran scoped Prettier write/check and git diff --check.

The initial formatter invocation attempted to load a plugin from the uninitialized skill-only worktree. It failed before formatting; using the existing coordinator's identical formatter configuration and installed plugins passed without installing dependencies or initializing/building core.

No package tests, builds, documentation regeneration, corpus runs, or release entries are needed for this Markdown-only change.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 8bf3420c-d859-4ac1-81e8-2081d1fded84
@msyyc
Yuchao Yan (msyyc) marked this pull request as ready for review October 10, 2026 09:13
@msyyc
Yuchao Yan (msyyc) merged commit 888ccb9 into feature/lintdiff-migration-new Oct 10, 2026
3 checks passed
@msyyc
Yuchao Yan (msyyc) deleted the skill/promote-sdk-operation-naming branch October 10, 2026 09:13
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