[v2] Publish the breaking-change inventory and migration guide

Abierto

#2,527 abierto el 4/9/2026 1 comentario 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Evaluación

Dificultad: 5/5
Tiempo estimado: Más de una semana
Aptitud para principiantes: 35/100

Tipo de issue: Documentación
Claridad: Bastante claro
Estado de actividad: Activo
Stack tecnológico: java
Área: documentation, release

Línea de trabajo

Empieza revisando las decisiones e implementaciones finales de los otros sub-issues de v2 y compáralas después con los paquetes de preview publicados. Crea el inventario por idioma, los ejemplos, las notas de compatibilidad, las sustituciones y las instrucciones de actualización, enlazando los issues de decisión y los pull requests de implementación. Se considera terminado cuando cada responsable del SDK afectado lo haya revisado y la guía esté enlazada desde las notas de la versión v2 y la documentación principal.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

documentation sdk-v2

Summary

Publish the authoritative breaking-change inventory and migration guidance for Copilot SDK v2.

This work depends on the final decisions and implementations in the other v2 sub-issues.

Required content

Per-language inventory of removed, renamed, and relocated APIs.
Before-and-after examples for every accepted breaking change.
Behavioral changes that may compile successfully but alter runtime behavior.
Supported replacements for removed APIs.
Runtime and CLI compatibility requirements.
Package/version upgrade instructions.
Links to the decision issues and implementation pull requests.
Explicit notes for historical proposals that were retained, superseded, deferred, or moved elsewhere.

Completion

The migration guide is reviewed by each affected SDK owner, matches the shipped preview packages, and is linked from the v2 release notes and primary documentation.

Lenguaje dominante: Java
Estrellas: 10.5k
Forks: 1.5k
Merge medio: 1 d 9 h
PR fusionados (30 d): 130