Azure / Azure/azure-sdk-tools

[TypeSpec Authoring] Align downstream SDK breaking-change assessment rules with SDK Review Board

Open
#16,993 0 comments 0 reactions 0 assignees View on GitHub
AzSDK Tools Agent dev inner loop needs-triage
Dominant language
C#
Stars
135
Forks
260
Avg merge
3d 1h
Merged PRs (30d)
143

Description

## Parent issue

Part of #14529.

## Problem

The downstream SDK breaking-change rules used by the assessment skill were initially authored without a confirmed SDK Review Board source of truth.

## Goal

Validate and align the assessment rules with SDK Review Board policy and documented language-specific compatibility guidance.

## Scope

- Start with Johnathon to identify existing policy, design notes, rule catalogs, and the appropriate reviewers.
- Review the current assessment rules with SDK Review Board stakeholders.
- Distinguish cross-language rules from language-specific rules and document precedence.
- Resolve conflicts, unsupported assumptions, and gaps in the current rules.
- Add traceable citations or provenance for every enforced rule.
- Define a process for keeping rules synchronized when board guidance changes.

## Acceptance criteria

- The relevant SDK Review Board stakeholders approve the rule set or record explicit open questions.
- Every downstream breaking-change rule has a documented source, owner, and applicability.
- Conflicting or speculative rules are corrected, removed, or clearly marked as provisional.
- Benchmark coverage is updated for materially changed rules.

Contributor guide

Open the contributing guide

Research direction

Start with Johnathon to locate the existing assessment rules, policy, design notes, and rule catalogs, then identify the appropriate SDK Review Board stakeholders. Compare the rules with approved cross-language and language-specific guidance, record sources, owners, applicability, and open questions, and update benchmark coverage for materially changed rules.

Written by the indexing model from the issue text.

Assessment

Domain
tooling
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.