[edburns]

Superseded by #249 .

Problem

Versioned preview documentation currently uses the shared SDK prerelease as the Maven, Gradle, and JBang coordinate. Java previews now use one rolling Maven snapshot per base version, so those examples would point to an unpublished coordinate.

Changes

• Add a separate optional artifact_version workflow input while preserving version for site directories and release/source identity.
• Render Maven, Gradle, JBang, and cookbook coordinates from the artifact version.
• Add Central snapshot repository configuration only for snapshot artifacts.
• Reject preview deployments that omit the artifact version so the runtime dispatcher and site contract roll out in order.

Validation

• node --test scripts/prepare-site-versions.test.mjs — passed (3 tests).
• mvn site -Dsite.version=1.0.15-preview.2 -Dartifact.version=1.0.15-SNAPSHOT ... — BUILD SUCCESS; rendered site kept 1.0.15-preview.2 metadata and used 1.0.15-SNAPSHOT plus snapshot repositories.
• mvn site -Dsite.version=1.0.15 -Dartifact.version=1.0.15 ... — BUILD SUCCESS; rendered stable coordinates remained 1.0.15 with no snapshot repository.

Rollout dependency

Merge this pull request before github/copilot-agent-runtime#33343 begins sending artifact_version. The runtime pull request remains draft until this receiving workflow is available.

[Copilot]

🟡 Changes recommended

The deployment workflow directly interpolates artifact_version into shell source, enabling command execution with repository and Pages write permissions before validation.

3 open issues

• Pass artifact_version through the step environment · New
• Decouple artifact version from the latest-release option · New
• Add snapshot repository to rewritten cookbook headers · New

What changed in this PR

Separates Java dependency coordinates from documentation versions so preview sites can reference rolling Maven snapshots while preserving release-specific site identity.

Changes:

• Adds an optional artifact_version deployment input and Maven property.
• Prepares dependency examples and conditionally adds snapshot repository instructions.
• Adds rendering tests and a guard intended to require artifact versions for preview deployments.

File	Description
src/​site/​markdown/​index.md	Uses artifact coordinates and repository placeholders in installation examples.
src/​site/​markdown/​getting-started.md	Updates setup examples for rolling snapshot artifacts.
scripts/​prepare-site-versions.test.mjs	Tests preview and stable preparation plus base-version validation.
scripts/​prepare-site-versions.mjs	Validates versions, rewrites coordinates, and renders repository instructions.
pom.xml	Defines an independently overridable artifact version.
.github/​workflows/​deploy-site.yml	Accepts the artifact version and passes it through site preparation and rendering.

_{Review effort: Balanced (auto)}