Skip to content

Commit 0f7961f

Browse files
Update CPM docs to clarify stable vs preview package sources
Co-authored-by: christiannagel <1908285+christiannagel@users.noreply.github.com>
1 parent a920a84 commit 0f7961f

1 file changed

Lines changed: 22 additions & 3 deletions

File tree

docs/central-package-management-multitargeting.md

Lines changed: 22 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -130,15 +130,31 @@ This is intentional because:
130130

131131
## Understanding Package Sources
132132

133+
### Package Version Strategy
134+
135+
The Codebreaker packages follow a clear versioning and distribution strategy:
136+
137+
**Stable Releases (nuget.org)**:
138+
- Released versions without preview suffixes (e.g., `3.8.0`, `3.9.0`)
139+
- Available on the public NuGet feed: https://www.nuget.org/packages?q=cninnovation.codebreaker
140+
- Used in production and for stable references
141+
142+
**Preview Releases (Azure DevOps)**:
143+
- Pre-release versions with preview suffixes (e.g., `3.8.0-preview.1.45`, `3.8.0-beta.11`)
144+
- Available on Azure DevOps feed: https://pkgs.dev.azure.com/cnilearn/codebreakerpackages/_packaging/codebreaker/nuget/v3/index.json
145+
- Used for testing and development before stable release
146+
133147
### Public NuGet Feed
134148
- **URL**: `https://api.nuget.org/v3/index.json`
135149
- **Purpose**: Standard .NET packages (Microsoft.*, System.*, etc.)
136150
- **Examples**: `Microsoft.AspNetCore.Authentication.JwtBearer`, `Aspire.*` packages
137151

138152
### Azure DevOps Artifacts Feed
139153
- **URL**: `https://pkgs.dev.azure.com/cnilearn/codebreakerpackages/_packaging/codebreaker/nuget/v3/index.json`
140-
- **Purpose**: Internal Codebreaker packages
141-
- **Examples**: `CNinnovation.Codebreaker.*` packages
154+
- **Purpose**: Preview/pre-release Codebreaker packages
155+
- **Examples**: `CNinnovation.Codebreaker.*` preview packages (e.g., `3.8.0-preview.1.45`)
156+
157+
**Note**: Stable/released versions of `CNinnovation.Codebreaker.*` packages are published to nuget.org and should be retrieved from there.
142158

143159
## Alternative Solutions
144160

@@ -162,11 +178,14 @@ Add package source mapping to `nuget.config`:
162178
<package pattern="System.*" />
163179
<package pattern="Aspire.*" />
164180
<package pattern="Azure.*" />
181+
<!-- Stable/released CNinnovation.Codebreaker packages -->
182+
<package pattern="CNinnovation.Codebreaker.*" />
165183
<package pattern="*" />
166184
</packageSource>
167185

168-
<!-- Codebreaker packages from Azure DevOps -->
186+
<!-- Preview/pre-release Codebreaker packages from Azure DevOps -->
169187
<packageSource key="codebreaker">
188+
<!-- Only preview versions like 3.8.0-preview.1.45 -->
170189
<package pattern="CNinnovation.Codebreaker.*" />
171190
</packageSource>
172191
</packageSourceMapping>

0 commit comments

Comments
 (0)