feat docs: update changelog for 2.14

Tests: протестировано CI, на прод не влияет
commit_hash:0081310e8c8df73b4b164ab08f2a3cac939c80b6

Author: apolukhin

core/include/userver/components/statistics_storage.hpp

@@ -12,23 +12,18 @@ USERVER_NAMESPACE_BEGIN
 
 namespace components {
 
-// clang-format off
-
 /// @ingroup userver_components
 ///
-/// @brief Component that keeps a utils::statistics::Storage storage for
-/// metrics.
+/// @brief Component that keeps a @ref utils::statistics::Storage storage for metrics.
 ///
-/// Returned references to utils::statistics::Storage live for a lifetime
+/// Returned references to @ref utils::statistics::Storage live for a lifetime
 /// of the component and are safe for concurrent use.
 ///
 /// The component does **not** have any options for service config.
 ///
 /// ## Static configuration example:
 ///
 /// @snippet components/common_component_list_test.cpp  Sample statistics storage component config
-
-// clang-format on
 class StatisticsStorage final : public RawComponentBase {
 public:
     /// @ingroup userver_component_names
@@ -70,9 +65,9 @@ inline constexpr auto kConfigFileMode<StatisticsStorage> = ConfigFileMode::kNotR
 
 namespace utils::statistics {
 
-/// @brief Add a writer function to @ref Storage from @ref StatisticsStorage.
-/// It automatically calls @ref Storage::RegisterWriter just after the component
-/// construction and @ref Entry::Unregister just before the component
+/// @brief Add a writer function to @ref Storage from @ref components::StatisticsStorage.
+/// It automatically calls @ref utils::statistics::Storage::RegisterWriter() just after the component
+/// construction and @ref utils::statistics::Entry::Unregister() just before the component
 /// destructor.
 ///
 /// @see @ref Storage::RegisterWriter.

libraries/s3api/include/userver/s3api/clients/s3api.hpp

@@ -191,37 +191,37 @@ class Client {
     /// Performs a CreateMultipartUpload S3 Action.
     /// Returns result with `upload ID` which is used to associate all of the parts in the specific multipart upload.
     /// You specify this `upload ID` in each of your subsequent upload part requests
-    /// For details see @ref https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
+    /// For details see https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
     virtual multipart_upload::InitiateMultipartUploadResult CreateMultipartUpload(
         const multipart_upload::CreateMultipartUploadRequest& request
     ) const = 0;
 
     /// @brief Upload a part in a multipart upload sequence.
     /// Performs an UploadPart S3 Action.
     /// Returns ETag value which you must include in the subsequent request to complete the multipart upload.
-    /// For details see @ref https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
+    /// For details see https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
     virtual multipart_upload::UploadPartResult UploadPart(const multipart_upload::UploadPartRequest& request) const = 0;
 
     /// @brief Complete a multipart upload by assembling previously uploaded parts.
     /// Performs a CompleteMultipartUpload S3 Action.
-    /// For details see @ref https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
+    /// For details see https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
     virtual multipart_upload::CompleteMultipartUploadResult CompleteMultipartUpload(
         const multipart_upload::CompleteMultipartUploadRequest& request
     ) const = 0;
 
     /// @brief Abort a multipart upload sequence.
     /// Performs an AbortMultipartUpload S3 Action.
-    /// For details see @ref https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
+    /// For details see https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
     virtual void AbortMultipartUpload(const multipart_upload::AbortMultipartUploadRequest& request) const = 0;
 
     /// @brief List the parts that have been uploaded for a specific multipart upload.
     /// Performs a ListParts S3 Action.
-    /// For details see @ref https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
+    /// For details see https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
     virtual multipart_upload::ListPartsResult ListParts(const multipart_upload::ListPartsRequest& request) const = 0;
 
     /// @brief List in-progress multipart uploads in a bucket
     /// Performs a ListMultipartUploads S3 Action.
-    /// For details see @ref https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
+    /// For details see https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
     virtual multipart_upload::ListMultipartUploadsResult ListMultipartUploads(
         const multipart_upload::ListMultipartUploadsRequest& request
     ) const = 0;

libraries/s3api/src/s3api/s3api_methods.cpp

@@ -48,7 +48,7 @@ constexpr std::string_view kEncodingTypeValueUrl = "url";
 
 constexpr std::string_view kS3AwsXmlNamespace = "http://s3.amazonaws.com/doc/2006-03-01/";
 
-// see @ref https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
+// see https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
 const unsigned kMaxUploadsListLimit = 1000u;
 
 }  // namespace

mongo/include/userver/storages/mongo/transaction.hpp

@@ -25,7 +25,7 @@ class TransactionImpl;
 ///
 /// ## Usage example:
 ///
-/// @snippet mongo/src/storages/mongo/transaction_mongotest.cpp [transaction]
+/// @snippet mongo/src/storages/mongo/transaction_mongotest.cpp transaction
 ///
 /// @note Transactions require MongoDB replica sets or sharded clusters.
 /// @note Operations within a transaction are automatically retried according

redis/src/storages/redis/client_cluster_redistest.cpp

@@ -192,6 +192,16 @@ UTEST_F(RedisClusterClientTest, TransactionDistinctShards) {
     UASSERT_THROW(transaction->Exec(kDefaultCc).Get(), storages::redis::RequestFailedException);
 }
 
+UTEST_F(RedisClusterClientTest, Generic) {
+    auto client = GetClient();
+    const storages::redis::CommandControl command_control{};
+    constexpr size_t kKeyIndex = 0;
+    /// [Sample generic command usage]
+    client->GenericCommand<void>("set", {"key0", "foo"}, kKeyIndex, command_control).Wait();
+    EXPECT_EQ(client->GenericCommand<std::string>("get", {"key0"}, kKeyIndex, command_control).Get(), "foo");
+    /// [Sample generic command usage]
+}
+
 // Must abort in debug builds
 #ifdef NDEBUG
 UTEST_F(RedisClusterClientTest, NotStartedTransactionNoExec) {

scripts/docs/doxygen.conf

@@ -1168,6 +1168,7 @@ EXAMPLE_PATH           = samples \
                          ydb/functional_tests \
                          otlp/src \
                          otlp/tests \
+                         libraries/multi-index-lru/src \
                          libraries/easy/samples
 
 # If the value of the EXAMPLE_PATH tag contains directories, you can use the

scripts/docs/en/userver/build/options.md

@@ -83,6 +83,8 @@ The exact format of setting cmake options varies depending on the method of buil
 | `USERVER_FEATURE_GRPC_REFLECTION` | Provide reflection service for gRPC                                               | `${USERVER_BUILD_ALL_COMPONENTS}`                           |
 | `USERVER_FEATURE_S3API`           | Provide S3 client for gRPC                                                        | `${USERVER_BUILD_ALL_COMPONENTS}`                           |
 | `USERVER_FEATURE_EASY`            | Provide library for easy prototyping                                              | `${USERVER_BUILD_ALL_COMPONENTS}`                           |
+| `USERVER_FEATURE_MULTI_INDEX_LRU` | Provide library for Multi Index LRU containers                                    | `${USERVER_BUILD_ALL_COMPONENTS}`                           |
+
 
 ### CMake options for building everything
 

scripts/docs/en/userver/roadmap_and_changelog.md

@@ -39,18 +39,33 @@ Changelog news also go to the
 
 * Added a @ref ugrpc::RichStatus builder for creating rich gRPC error statuses with
   structured details following Google's error model
+* Added a @ref utils::statistics::RegisterWriterScope for safe and easy registration of statistics.
+* No more need to call `CacheUpdateTrait::StartPeriodicUpdates()` from your caching components.  
 * Implemented a Multi Index LRU container, thanks to [hzhdlrp](https://github.com/hzhdlrp).
 * Statement name is now logged when using @ref storages::postgres::Portal.
+* Monitor port is now opened before all the components and handlers are started, leading to more control and
+  information on service start.
 * @ref storages::postgres::DistLockComponentBase now can be configured at runtime via @ref POSTGRES_DISTLOCK_SETTINGS.
 * Added @ref utils::TaskBuilder
 * ‎@ref scripts/docs/en/userver/libraries/s3api.md now has @ref QUALITY_TIERS "Platinum Tier".
 * Kafka is now more accurate in computing message time spent in @ref kafka::ConsumerComponent queue.
 * @ref utils::statistics::RecentPeriod is does not lose precision under heavy contention.
-* Added functionality to @ref ‎scripts/docs/en/userver/dump_coroutines.md
+* Added functionality to @ref scripts/docs/en/userver/dump_coroutines.md
 * Added DeadlockDetector that can be enabled via `coro_pool.deadlock_detector` option
   in @ref components::ManagerControllerComponent.
 * Added @ref storages::mongo::Transaction
 * Added @ref server::middlewares::Cors
+* Added @ref utils::FromStringNoThrow
+* Fixed unnecessary lock in TaskContext desctructor when there are no plugins. Many thanks to
+  [Ivan Trofimov](https://github.com/itrofimow) for the PR
+* @ref formats::yaml::Value now checks for key uniqueness in mappings.
+* @ref scripts/docs/en/userver/gdb_debugging.md "Stack monitor usage" is not automatically disabled under GDB.
+* Disabled phdr cache if ASAN is enabled. Many thanks to
+  [Yury Bogomolov](https://github.com/ybogo) for the PR
+* Allowed using mapped enums in @ref storages::postgres::ParameterStore. Many thanks to Aleksey Popov for the patch and
+  help!
+* Fixed error in [uservice-dynconf](https://github.com/userver-framework/uservice-dynconf) schema. Many thanks to
+  [Repin Daniil](https://github.com/Repin-Daniil) for the PR!
 * @ref components::ComponentContext::RegisterScope() now can be used to register some resource that will be
   called after the component is successfully created (including all
   class descendants) and destroyed right before calling the destructor of the most derived component. This is a low
@@ -77,15 +92,19 @@ Changelog news also go to the
   * Added multipart methods support for testsuite @ref pytest_userver.plugins.s3api "s3api plugin".
   * @ref utils::FromString() now reports if input sequence of chars to convert contains '\0' character.
   * Improved diagnostics for PostgreSQL composite types related errors, including nested composite types.
+  * Fixed typo in third party. Many thanks to [shuric80](https://github.com/shuric80) for the PR!
+  * Fixed typo in Docker badge link for upastebin. Many thanks to [Гуща Иван](https://github.com/Ivan160927777)
+    for the PR!
   * A lot of updates for different sections of documentation, including @ref utils::FixedArray,
-    @ref ‎scripts/docs/en/userver/deadline_propagation.md, @ref clients::http::Request,
-    @ref ‎scripts/docs/en/userver/gdb_debugging.md.
+    @ref scripts/docs/en/userver/deadline_propagation.md, @ref clients::http::Request,
+    @ref scripts/docs/en/userver/gdb_debugging.md, @ref scripts/docs/en/userver/long_transactions.md,
+    @ref scripts/docs/en/userver/mongodb.md, @ref scripts/docs/en/userver/congestion_control.md
 
 
 Plugins are renamed to middlewares and @ref components::HttpClient was split into @ref components::HttpClient
   and @ref components::HttpClientCore.
 
-**Migration guide**:
+#### Migration guide from v2.13 to v2.14
 
 1. Instead of `.Append<components::HttpClient>()` use `.AppendComponentList(clients::http::ComponentList())` in
    your component list (see @ref clients::http::ComponentList "docs").
@@ -208,6 +227,8 @@ Plugins are renamed to middlewares and @ref components::HttpClient was split int
    +                http-client-middleware-with-dynamic-config:
    +                    enabled: false
    ```
+7. Remove calls to `CacheUpdateTrait::StopPeriodicUpdates()`. Remove calls to `CacheUpdateTrait::StartPeriodicUpdates()`
+   or replace them with @ref CacheUpdateTrait::EarlyStartPeriodicUpdates() if early update is required.
 
 
 ### Release v2.13
@@ -275,7 +296,7 @@ Plugins are renamed to middlewares and @ref components::HttpClient was split int
   * Clarified ownership of buckets in @ref utils::statistics::Histogram.
   * Added mirrors to the videos at @ref scripts/docs/en/userver/publications.md.
   * Redis now provides much more information in logs.
-  * Added troubleshooting info on `SIGUSR1` to @ref ‎scripts/docs/en/userver/faq.md .
+  * Added troubleshooting info on `SIGUSR1` to @ref scripts/docs/en/userver/faq.md .
 
 
 ### Release v2.12