fix(stackable-operator): Improve AwsRegion::name() ergonomics (#963)

* fix(stackable-operator): Improve AwsRegion::name() ergonomics with &self parameter and return `Option<&str>`

* doc(stackable-operator): Update doc

* chore(stackable-operator): Update changelog

Author: NickLarsenNZ

crates/stackable-operator/CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes to this project will be documented in this file.
 
 ## [Unreleased]
 
+### Fix
+
+- BREAKING: Improve `AwsRegion::name()` ergonomics: borrow self and return `Option<&str>` ([#963]).
+
+[#963]: https://github.com/stackabletech/operator-rs/pull/963
+
 ## [0.86.1] - 2025-02-21
 
 ### Added

crates/stackable-operator/src/commons/s3/crd.rs

@@ -124,15 +124,15 @@ impl AwsRegion {
     ///
     /// ```
     /// # use stackable_operator::commons::s3::AwsRegion;
-    /// # fn set_property(key: &str, value: String) {}
+    /// # fn set_property(key: &str, value: &str) {}
     /// # fn example(aws_region: AwsRegion) {
     /// if let Some(region_name) = aws_region.name() {
     ///     // set some property if the region is set, or is the default.
     ///     set_property("aws.region", region_name);
     /// };
     /// # }
     /// ```
-    pub fn name(self) -> Option<String> {
+    pub fn name(&self) -> Option<&str> {
         match self {
             AwsRegion::Name(name) => Some(name),
             AwsRegion::Source(_) => None,