Repository navigation
Clarify v1 versioning direction - #1227
Merged
Merged
Conversation
|
Azure Pipelines: There may be pipelines that require an authorized user to comment /azp run to run. |
Contributor
There was a problem hiding this comment.
Copilot review overview
🟡 Changes recommended
The alias policy incorrectly claims schema/parser agreement for legacy v0.6-v0.8 contracts.
Get a fresh assessment by requesting another Copilot review.
Review effort: Balanced
Findings: 1
Open (1)
What changed in this PR
Clarifies the transition from exact v0.x contracts to planned major-line v1 SDK versioning.
Changes:
- Defines v1 minor-version compatibility.
- Documents v1.0/v1.1 contract lineage and registry metadata.
- Revises deprecation-alias policy.
| File | Description |
|---|---|
docs/versioning.md |
Updates versioning, artifact-generation, and alias guidance. |
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
Gudge (MGudgin)
force-pushed
the
user/gudge/v1-versioning-docs
branch
from
September 22, 2026 15:57
cf93119 to
bb3f93d
Compare
This PR updates the versioning design to distinguish current v0.x exact contract selection from the planned v1 SDK major-line model. Details * Define source-compatible minor evolution within an SDK major line. * Record the v1.0 baseline and v1.1 development-contract transition. * Document registry-owned artifact and request-root metadata. * Align deprecation aliases with exact contracts and major compatibility. * Document legacy stable-schema exceptions for parser aliases. Tests * `git -c core.whitespace=cr-at-eol diff --check` Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 3e39bcce-697d-4dfe-918d-547fb944be79 Generated-with: gpt-5.6-sol
Gudge (MGudgin)
force-pushed
the
user/gudge/v1-versioning-docs
branch
from
September 22, 2026 19:04
bb3f93d to
bce9014
Compare
Contributor
There was a problem hiding this comment.
Copilot review overview
🟡 Changes recommended
The documentation incorrectly states that request-root metadata drives artifact generation rather than post-generation validation.
Get a fresh assessment by requesting another Copilot review.
Review effort: Balanced
Findings: 1
Comment on lines
+285
to
+290
| Each `ContractDescriptor` also owns whether that contract generates artifacts | ||
| and the request roots used for generation and fixture validation. Each | ||
| registered root names its fixture directory and schema definition. The codegen | ||
| gate consumes this metadata directly, so a generated contract cannot silently | ||
| omit a request root. Legacy v0.6-v0.8 contracts intentionally advertise no | ||
| generated request roots. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.

This PR updates the versioning design to distinguish the current v0.x exact-version SDK behavior from the planned v1 major-line model.
Details:
experimentalJSON wrapper.Tests
git -c core.whitespace=cr-at-eol diff --checkMicrosoft Reviewers: Open in CodeFlow