@@ -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