cc docs: clarify ownership of buckets in utils::statistics::Histogram docs

commit_hash:30d7bba541c38616138679f4d2551d7fe5dbf827

Author: Anton3

core/include/userver/utils/statistics/histogram.hpp

@@ -62,8 +62,10 @@ struct BoundsBlock;
 /// @snippet utils/statistics/histogram_test.cpp  metric tag
 class Histogram final {
 public:
-    /// Sets upper bounds for each non-"infinite" bucket. The lowest bound is
+    /// @brief Sets upper bounds for each non-"infinite" bucket. The lowest bound is
     /// always 0.
+    ///
+    /// @param upper_bounds is copied inside and is not required to be kept alive after the constructor completes.
     explicit Histogram(utils::span<const double> upper_bounds);
 
     /// Copies an existing histogram.

core/include/userver/utils/statistics/histogram_aggregator.hpp

@@ -1,14 +1,14 @@
 #pragma once
 
+/// @file userver/utils/statistics/histogram_aggregator.hpp
+/// @brief @copybrief utils::statistics::HistogramAggregator
+
 #include <memory>
 
 #include <userver/utils/span.hpp>
 #include <userver/utils/statistics/fwd.hpp>
 #include <userver/utils/statistics/histogram_view.hpp>
 
-/// @file userver/utils/statistics/histogram_aggregator.hpp
-/// @brief @copybrief utils::statistics::HistogramAggregator
-
 USERVER_NAMESPACE_BEGIN
 
 namespace utils::statistics {
@@ -19,6 +19,10 @@ namespace utils::statistics {
 /// @snippet utils/statistics/histogram_test.cpp  HistogramAggregator
 class HistogramAggregator final {
 public:
+    /// @brief Sets upper bounds for each non-"infinite" bucket. The lowest bound is
+    /// always 0.
+    ///
+    /// @param upper_bounds is copied inside and is not required to be kept alive after the constructor completes.
     explicit HistogramAggregator(utils::span<const double> upper_bounds);
 
     HistogramAggregator(HistogramAggregator&&) noexcept;

core/src/utils/statistics/histogram_test.cpp

@@ -91,7 +91,7 @@ UTEST(StatisticsHistogram, Sample) {
     /// [sample]
     utils::statistics::Storage storage;
 
-    utils::statistics::Histogram histogram{std::vector<double>{1.5, 5, 42, 60}};
+    utils::statistics::Histogram histogram{{1.5, 5, 42, 60}};
 
     auto statistics_holder =
         storage.RegisterWriter("test", [&](utils::statistics::Writer& writer) { writer = histogram; });