fix: Fix the CRD description of ClientAuthenticationDetails (#846)

* fix: Fix the CRD description of ClientAuthenticationDetails

* changelog

* fix

* fix

crates/stackable-operator/CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes to this project will be documented in this file.
 
 ## [Unreleased]
 
+### Fixed
+
+- Fix the CRD description of `ClientAuthenticationDetails` to not contain internal Rust doc, but a public CRD description ([#846]).
+
+[#846]: https://github.com/stackabletech/operator-rs/pull/846
+
 ## [0.74.0] - 2024-08-22
 
 ### Added

crates/stackable-operator/src/commons/authentication/mod.rs

@@ -125,15 +125,17 @@ impl AuthenticationClass {
 #[serde(rename_all = "camelCase")]
 #[schemars(description = "")]
 pub struct ClientAuthenticationDetails<O = ()> {
-    /// A name/key which references an authentication class. To get the concrete
-    /// [`AuthenticationClass`], we must resolve it. This resolution can be
-    /// achieved by using [`ClientAuthenticationDetails::resolve_class`].
+    /// Name of the [AuthenticationClass](https://docs.stackable.tech/home/nightly/concepts/authentication) used to
+    /// authenticate users.
+    //
+    // To get the concrete [`AuthenticationClass`], we must resolve it. This resolution can be achieved by using
+    // [`ClientAuthenticationDetails::resolve_class`].
     #[serde(rename = "authenticationClass")]
     authentication_class_ref: String,
 
-    /// This field contains authentication provider specific configuration.
-    ///
-    /// Use [`ClientAuthenticationDetails::oidc_or_error`] to get the value or report an error to the user.
+    /// This field contains OIDC-specific configuration. It is only required in case OIDC is used.
+    //
+    // Use [`ClientAuthenticationDetails::oidc_or_error`] to get the value or report an error to the user.
     // TODO: Ideally we want this to be an enum once other `ClientAuthenticationOptions` are added, so
     // that user can not configure multiple options at the same time (yes we are aware that this makes a
     // changing the type of an AuthenticationClass harder).

crates/stackable-operator/src/commons/authentication/oidc.rs

@@ -232,8 +232,8 @@ pub struct ClientAuthenticationOptions<T = ()> {
     #[serde(default)]
     pub extra_scopes: Vec<String>,
 
-    /// If desired, operators can add custom fields that are only needed for this specific product.
-    /// They need to create a struct holding them and pass that as `T`.
+    // If desired, operators can add custom fields that are only needed for this specific product.
+    // They need to create a struct holding them and pass that as `T`.
     #[serde(flatten)]
     pub product_specific_fields: T,
 }