Azure / Azure/azure-sdk-tools

[APIView] POC Cross-Language Discussions & Proposals for APIView

Open
#14,756 0 comments 0 reactions 0 assignees View on GitHub
APIView
Dominant language
C#
Stars
135
Forks
260
Avg merge
3d 1h
Merged PRs (30d)
143

Description

Add a dedicated cross-language discussions experience to APIView that enables language architects and SDK teams to collaborate on API surface alignment across languages — with a structured proposal and voting workflow.

## Problem

Today, when reviewing APIs that span multiple languages (e.g., a TypeSpec-defined service), reviewers leave comments on individual language revisions with no structured way to:
- See all cross-language feedback in one place
- Propose changes to the shared TypeSpec definition
- Vote on proposals per-language team
- Track which cross-language discussions need attention or have TODOs

Contributor guide

Open the contributing guide

Research direction

Start by reading the APIView experience and the existing language-revision review flow. Define what a dedicated cross-language discussions experience should cover, including shared TypeSpec proposals, per-language voting, and tracking discussions that need attention or TODOs; done means these requirements are addressed in a reviewed POC.

Written by the indexing model from the issue text.

Assessment

Domain
api, developer-experience
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Needs clarification
Newbie friendliness
30/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.