Document the possible values of Warehouse imageSelectionStrategy

[Chewie]

Checklist

• I've searched the issue queue to verify this is not a duplicate feature request.
• I've pasted the output of kargo version, if applicable.
• I've pasted logs, if applicable.

Proposed Feature

Add an entry in the docs for the possible values of imageSelectionStrategy, namely Digest, Lexical and NewestBuild.

Motivation

Playing around with Kargo for evaluation, I wanted to try a toy continuous delivery scenario without semver:

• A push on main on the app repo triggers tests and a new image build
• That new image is immediately deployed to a staging cluster
• Some sort of E2E tests and/or human validation is made and triggers the next stage
• The new version is now deployed in production

However, I found it difficult to find the information to represent this scenario. The key concepts kind of implies that a semver approach is recommended, and while the CRD Reference shows an imageSelectionStrategy field, it doesn't show what the possible values are.

I was only able to discover the possible values Digest, Lexical and NewestBuild by looking at the old 0.4.0 release notes.

However, I'm not sure if this is an oversight or an information hidden on purpose. If it is the latter, what would be the recommended approach to implement this scenario? On a more general note, I'd be interested to know if the project has strong opinions regarding promotion strategies, in particular those that want to move away from tagging releases.

Cheers!

[krancour]

Thanks for opening this issue. You're the second to notice this in as many days.

It wasn't deliberate.

It's a combination of hand-written docs still evolving and us being taken by surprise that the enumerated accepted values for this field were not included in the generated documentation.

For reference, we had incorrectly expected this:

kargo/api/v1alpha1/warehouse_types.go

Lines 15 to 16 in f30f66b

	// +kubebuilder:validation:Enum={Digest,Lexical,NewestBuild,SemVer}
	type ImageSelectionStrategy string

To surface here:

https://doc.crds.dev/github.com/akuity/kargo/kargo.akuity.io/Warehouse/[email protected]#spec-subscriptions-image-imageSelectionStrategy