feat docs: fix some of the Doxygen noted issues

Tests: протестировано CI
commit_hash:e8d1b24fbe9ccaeca2cae88d6bd3a5d4b0b628cd

Author: apolukhin

README.md

@@ -1,6 +1,7 @@
 # userver [<img src="./scripts/docs/img/logo.svg" align='right' width="10%">](https://userver.tech/)
 
 [![Ubuntu](https://github.com/userver-framework/userver/actions/workflows/ci.yml/badge.svg)](https://github.com/userver-framework/userver/actions/workflows/ci.yml)
+[![Fedora](https://github.com/userver-framework/userver/actions/workflows/fedora.yml/badge.svg)](https://github.com/userver-framework/userver/actions/workflows/fedora.yml)
 [![MacOS](https://github.com/userver-framework/userver/actions/workflows/macos.yml/badge.svg)](https://github.com/userver-framework/userver/actions/workflows/macos.yml)
 [![Alpine](https://github.com/userver-framework/userver/actions/workflows/alpine.yml/badge.svg)](https://github.com/userver-framework/userver/actions/workflows/alpine.yml)
 [![Docker CI](https://github.com/userver-framework/userver/actions/workflows/docker.yaml/badge.svg)](https://github.com/userver-framework/userver/actions/workflows/docker.yaml)

kafka/include/userver/kafka/exceptions.hpp

@@ -117,18 +117,18 @@ class ParseHeadersException final : std::runtime_error {
 };
 
 /// @brief Exception thrown when Seek* process failed.
-/// @ref ConsumeScope::Seek
-/// @ref ConsumeScope::SeekToBeginning
-/// @ref ConsumeScope::SeekToEnd
+/// @ref ConsumerScope::Seek
+/// @ref ConsumerScope::SeekToBeginning
+/// @ref ConsumerScope::SeekToEnd
 class SeekException final : public std::runtime_error {
 public:
     using std::runtime_error::runtime_error;
 };
 
 /// @brief Exception thrown when Seek* arguments are invalid.
-/// @ref ConsumeScope::Seek
-/// @ref ConsumeScope::SeekToBeginning
-/// @ref ConsumeScope::SeekToEnd
+/// @ref ConsumerScope::Seek
+/// @ref ConsumerScope::SeekToBeginning
+/// @ref ConsumerScope::SeekToEnd
 class SeekInvalidArgumentException final : public std::invalid_argument {
 public:
     using std::invalid_argument::invalid_argument;

kafka/include/userver/kafka/rebalance_types.hpp

@@ -30,7 +30,7 @@ struct TopicPartitionView final {
 using TopicPartitionBatchView = utils::span<const TopicPartitionView>;
 
 /// @brief Callback invoked when a rebalance event occurs.
-/// @warning The rebalance callback must be set before calling ConsumeScope::Start or after calling ConsumeScope::Stop .
+/// @warning The rebalance callback should be set before calling ConsumerScope::Start or after ConsumerScope::Stop.
 /// The callback must not throw exceptions; any thrown exceptions will be caught and logged by the consumer
 /// implementation.
 /// @note The callback is invoked after the assign or revoke event has been successfully processed.

scripts/docs/en/userver/dynamic_config.md

@@ -1,7 +1,7 @@
 ## Dynamic config
 
 For schemas of dynamic configs used by userver itself:
-@see @ref scripts/docs/en/schemas/dynamic_configs.md
+@see @ref scripts/docs/en/dynamic_configs/dynamic_configs.md
 
 For information on how to write a service that distributes dynamic configs:
 @see @ref scripts/docs/en/userver/tutorial/config_service.md
@@ -317,7 +317,7 @@ then you may skip this section entirely and use defaults only for testing.
 
 On the other hand, if you prefer to run without a configs service, then you
 may want to override some of the
-@ref scripts/docs/en/schemas/dynamic_configs.md "built-in userver configs".
+@ref scripts/docs/en/dynamic_configs/dynamic_configs.md "built-in userver configs".
 
 Defaults can be overridden in the config of the `dynamic-config` component:
 
@@ -678,5 +678,5 @@ going from the lowest to the highest priority:
 ----------
 
 @htmlonly <div class="bottom-nav"> @endhtmlonly
-⇦ @ref rabbitmq_driver | @ref scripts/docs/en/schemas/dynamic_configs.md ⇨
+⇦ @ref rabbitmq_driver | @ref scripts/docs/en/dynamic_configs/dynamic_configs.md ⇨
 @htmlonly </div> @endhtmlonly

scripts/docs/en/userver/faq.md

@@ -121,13 +121,13 @@ acquire connection + execute query <= network timeout
 ```
 
 See PostgreSQL related
-@ref scripts/docs/en/schemas/dynamic_configs.md for more info.
+@ref scripts/docs/en/dynamic_configs/dynamic_configs.md for more info.
 
 
 ### PostgreSQL: Statement XXXX was canceled
 
 Statement was canceled by the `statement timeout`. See PostgreSQL related
-@ref scripts/docs/en/schemas/dynamic_configs.md for more info.
+@ref scripts/docs/en/dynamic_configs/dynamic_configs.md for more info.
 
 
 ### PostgreSQL: Something is slow

scripts/docs/en/userver/framework_comparison.md

@@ -19,7 +19,7 @@ use ❌ and ❓ respectively.
 | Programming model for IO-bound apps    | stackful coroutines                                         | stackful coroutines    | actors                                    | stackless coroutines           | callbacks / stackless coroutines | thread pool             |
 | Programming language to use            | С++                                                         | Go-lang                | Python, JS, .Net, PHP, Java, Go           | Rust                           | C++                              | C++                     |
 | Caching data from remote or DB         | ✔️ @ref scripts/docs/en/userver/caches.md "[↗]"             | ❌                      | ❌                                         | ❌                              | ❌                                | ✔️ [[↗]][poco-cache]    |
-| Dynamic Config @ref fcmp1 "[1]"        | ✔️ @ref scripts/docs/en/schemas/dynamic_configs.md "[↗]"    | ✔️ [[↗]][gom-features] | ❌                                         | ❌                              | ❌                                | ❌                       |
+| Dynamic Config @ref fcmp1 "[1]"        | ✔️ @ref scripts/docs/en/dynamic_configs/dynamic_configs.md "[↗]" | ✔️ [[↗]][gom-features] | ❌                                         | ❌                              | ❌                                | ❌                       |
 | Unit testing                           | ✔️ C++ @ref scripts/docs/en/userver/testing.md "[↗]"        | ✔️ via Go-lang         | ✔️ PHP [[↗]][dapr-testig]                 | ✔️                             | ✔️ [[↗]][drog-testig]            | ❓                       |
 | Functional Testing @ref fcmp2 "[2]"    | ✔️ @ref scripts/docs/en/userver/functional_testing.md "[↗]" | ❌                      | ❌ [[↗]][dapr-testig]                      | ❌ [[↗]][actix-test]            | ❌ [[↗]][drog-testig]             | ❓                       |
 | Async synchronization primitives       | ✔️ @ref scripts/docs/en/userver/synchronization.md "[↗]"    | ✔️ via Go-lang         | ❌ [forces turn based access][dapr-actors] | ✔️ [[↗]][tokio-sync]           | ❌                                | ✔️ [[↗]][poco-sync]     |

scripts/docs/en/userver/log_level_running_service.md

@@ -255,6 +255,6 @@ This configuration disables:
 ----------
 
 @htmlonly <div class="bottom-nav"> @endhtmlonly
-⇦ @ref scripts/docs/en/schemas/dynamic_configs.md | @ref scripts/docs/en/userver/requests_in_flight.md ⇨
+⇦ @ref scripts/docs/en/dynamic_configs/dynamic_configs.md | @ref scripts/docs/en/userver/requests_in_flight.md ⇨
 @htmlonly </div> @endhtmlonly
 

scripts/docs/en/userver/roadmap_and_changelog.md

@@ -143,7 +143,7 @@ Changelog news also go to the
   [Konstantin Goncharik](https://github.com/botanegg) for the PR!
 * Allow dynamic selection of response streaming. Many thanks to [Sergei Fedorov](https://github.com/zmij)
   for the PR!
-* Added support for @ref mongo::options::Hint for @ref storages::mongo::operations::Delete,
+* Added support for @ref storages::mongo::options::Hint for @ref storages::mongo::operations::Delete,
   @ref storages::mongo::bulk_ops::Update and @ref  storages::mongo::bulk_ops::Delete.
 * @ref storages::Query now used in ClickHouse, MySQL and SQLite drivers, making it possible to directly use result of
   generation @ref scripts/docs/en/userver/sql_files.md "external SQL/YQL files". storages::Query::Statement() and

scripts/docs/en/userver/tutorial/postgres_service.md

@@ -116,7 +116,7 @@ Note the `dynamic-config.defaults` usage. In
 @ref scripts/docs/en/userver/tutorial/production_service.md "production ready service"
 those values are usually retrieved from remote server, so that they could be
 changed at runtime without any need to restart the service. See
-@ref scripts/docs/en/schemas/dynamic_configs.md for more info.
+@ref scripts/docs/en/dynamic_configs/dynamic_configs.md for more info.
 
 
 ### int main()

scripts/docs/en/userver/tutorial/production_service.md

@@ -146,7 +146,7 @@ file (if it exists).
 @note Dynamic configs is an essential part of a reliable service with high
       availability. Those could be used as an emergency switch for new
       functionality, selector for experiments, limits/timeouts/log-level setup,
-      proxy setup. See @ref scripts/docs/en/schemas/dynamic_configs.md for
+      proxy setup. See @ref scripts/docs/en/dynamic_configs/dynamic_configs.md for
       more info and @ref scripts/docs/en/userver/tutorial/config_service.md for
       insights on how to implement such service.