docs: fix rustdoc warnings (broken intra-doc links, bare URLs)

stackable-operator: intra-doc links within the crate must use `crate::`
rather than the package name `stackable_operator::`, which is not in
scope and produced `broken_intra_doc_links` warnings. Also wrap two bare
URLs in the scaler docs in angle brackets so rustdoc renders them as
hyperlinks.

stackable-telemetry: `SettingsBuilder` is not imported in
`tracing/mod.rs` (only `Settings` is), so the four doc links to it did
not resolve. Point them at `settings::SettingsBuilder` via the child
module, keeping the rendered link text unchanged.

`cargo doc --document-private-items` is now warning-free across the
workspace.

Author: adwk67

crates/stackable-operator/src/crd/scaler/mod.rs

@@ -31,8 +31,8 @@ pub mod versioned {
         ///
         /// Upstream issues:
         ///
-        /// - https://github.com/kubernetes/kubernetes/issues/105533
-        /// - https://github.com/Arnavion/k8s-openapi/issues/136
+        /// - <https://github.com/kubernetes/kubernetes/issues/105533>
+        /// - <https://github.com/Arnavion/k8s-openapi/issues/136>
         pub replicas: u16,
     }
 }

crates/stackable-operator/src/v2/builder/meta.rs

@@ -6,7 +6,7 @@ use crate::{
 };
 
 /// Infallible variant of
-/// [`stackable_operator::builder::meta::ObjectMetaBuilder::ownerreference_from_resource`]
+/// [`crate::builder::meta::ObjectMetaBuilder::ownerreference_from_resource`]
 pub fn ownerreference_from_resource(
     resource: &(impl Resource<DynamicType = ()> + HasName + HasUid),
     block_owner_deletion: Option<bool>,

crates/stackable-operator/src/v2/builder/pdb.rs

@@ -9,7 +9,7 @@ use crate::{
 };
 
 /// Infallible variant of
-/// [`stackable_operator::builder::pdb::PodDisruptionBudgetBuilder::new_with_role`]
+/// [`crate::builder::pdb::PodDisruptionBudgetBuilder::new_with_role`]
 pub fn pod_disruption_budget_builder_with_role(
     owner: &(impl Resource<DynamicType = ()> + HasName + NameIsValidLabelValue + HasUid),
     product_name: &ProductName,

crates/stackable-operator/src/v2/builder/pod/container.rs

@@ -23,7 +23,7 @@ pub enum Error {
     ParseEnvVarName { env_var_name: String },
 }
 
-/// Infallible variant of [`stackable_operator::builder::pod::container::ContainerBuilder::new`]
+/// Infallible variant of [`crate::builder::pod::container::ContainerBuilder::new`]
 pub fn new_container_builder(container_name: &ContainerName) -> ContainerBuilder {
     ContainerBuilder::new(container_name.as_ref()).expect("should be a valid container name")
 }

crates/stackable-operator/src/v2/builder/pod/volume.rs

@@ -5,7 +5,7 @@ use crate::{
     v2::types::kubernetes::{ListenerClassName, ListenerName, PersistentVolumeClaimName},
 };
 
-/// Infallible variant of [`stackable_operator::builder::pod::volume::ListenerReference`]
+/// Infallible variant of [`crate::builder::pod::volume::ListenerReference`]
 #[derive(Clone, Debug, Eq, PartialEq)]
 pub enum ListenerReference {
     ListenerClass(ListenerClassName),
@@ -26,7 +26,7 @@ impl From<&ListenerReference> for crate::builder::pod::volume::ListenerReference
 }
 
 /// Infallible variant of
-/// [`stackable_operator::builder::pod::volume::ListenerOperatorVolumeSourceBuilder::build_pvc`]
+/// [`crate::builder::pod::volume::ListenerOperatorVolumeSourceBuilder::build_pvc`]
 pub fn listener_operator_volume_source_builder_build_pvc(
     listener_reference: &ListenerReference,
     labels: &Labels,

crates/stackable-operator/src/v2/role_utils.rs

@@ -22,15 +22,15 @@ use crate::{
     schemars::{self, JsonSchema},
 };
 
-// Variant of [`stackable_operator::role_utils::GenericCommonConfig`] that implements [`Merge`]
+// Variant of [`crate::role_utils::GenericCommonConfig`] that implements [`Merge`]
 #[derive(Clone, Debug, Default, Deserialize, JsonSchema, Eq, PartialEq, Serialize)]
 pub struct GenericCommonConfig {}
 
 impl Merge for GenericCommonConfig {
     fn merge(&mut self, _defaults: &Self) {}
 }
 
-/// Variant of [`stackable_operator::role_utils::RoleGroup`] that is easier to work with
+/// Variant of [`crate::role_utils::RoleGroup`] that is easier to work with
 ///
 /// Differences are:
 /// * `replicas` is non-optional.

crates/stackable-telemetry/src/tracing/mod.rs

@@ -133,7 +133,7 @@ pub enum Error {
 /// ## Builders
 ///
 /// When choosing the builder, there are two different styles to configure individual subscribers:
-/// Using the sophisticated [`SettingsBuilder`] or the simplified tuple style for basic
+/// Using the sophisticated [`SettingsBuilder`](settings::SettingsBuilder) or the simplified tuple style for basic
 /// configuration. Currently, three different subscribers are supported: console output, OTLP log
 /// export, and OTLP trace export.
 ///
@@ -173,9 +173,9 @@ pub enum Error {
 /// subscriber provides specific settings based on a common set of options. These options can be
 /// customized via the following methods:
 ///
-/// - [`SettingsBuilder::console_log_settings_builder`]
-/// - [`SettingsBuilder::otlp_log_settings_builder`]
-/// - [`SettingsBuilder::otlp_trace_settings_builder`]
+/// - [`SettingsBuilder::console_log_settings_builder`](settings::SettingsBuilder::console_log_settings_builder)
+/// - [`SettingsBuilder::otlp_log_settings_builder`](settings::SettingsBuilder::otlp_log_settings_builder)
+/// - [`SettingsBuilder::otlp_trace_settings_builder`](settings::SettingsBuilder::otlp_trace_settings_builder)
 ///
 /// ```
 /// # use stackable_telemetry::tracing::{Tracing, Error, settings::Settings};