[epic] Review and finalize v1 APIs for OperatorController

[joelanford]

Design Documents

• Brief
• RFC

Tasks

• Update GoDoc comments to be user readable #1143
• api: move catalog sourcing fields to discriminated union #1088
• Update GoDoc field name references to use the JSON field name #1144
• Convert boolean fields to enums #1145
• Update fields in the spec to no longer be a pointer #1146
• Ensure optional fields have the // +optional tag #1147
• Logically group fields in the spec #1148
• Update validations for fields referencing the name of something to follow Kubernetes #1149
• Update the ClusterExtension.Spec.Channel field to be a list of channels #1150
• Update the allowed values of the ClusterExtension.Spec.UpgradeConstraintPolicy to be more descriptive #1151
• Update the ClusterExtension.Spec.PackageName field to be immutable #1152
• Simplify the reasons used in status conditions to only Succeeded and Failed #1153
• Promote v1alpha1 ClusterExtension API version to v1 #1155
• RFC: Review and update OperatorController condition types and status update logic #1256
• [v1 API Review] Update Installed Status condition usage #1291
• [v1 API Review] Add Progressing status condition #1292
• [v1 API Review] Remove the Resolved status condition #1293
• [v1 API Review] Remove the Unpacked status condition #1294
• [v1 API Review] Remove the Healthy status condition #1295
• Remove .status.resolution field #1306
• operator-controller external API review updates #1426

[acornett21]

• Depends-on: [epic] Review and finalize v1 APIs for Catalogd catalogd#239

[joelanford]

Related: #1088