cc docs: fix docs links and formatting

commit_hash:e0c3ada8a638611411d4468691cbfbeec22b212c

Author: Anton3

.mapping.json

@@ -3831,8 +3831,8 @@
   "scripts/docs/en/userver/grpc/middlewares_configuration.md":"taxi/uservices/userver/scripts/docs/en/userver/grpc/middlewares_configuration.md",
   "scripts/docs/en/userver/grpc/middlewares_order.md":"taxi/uservices/userver/scripts/docs/en/userver/grpc/middlewares_order.md",
   "scripts/docs/en/userver/grpc/middlewares_toggle.md":"taxi/uservices/userver/scripts/docs/en/userver/grpc/middlewares_toggle.md",
+  "scripts/docs/en/userver/grpc/server_middleware_implementation.md":"taxi/uservices/userver/scripts/docs/en/userver/grpc/server_middleware_implementation.md",
   "scripts/docs/en/userver/grpc/server_middlewares.md":"taxi/uservices/userver/scripts/docs/en/userver/grpc/server_middlewares.md",
-  "scripts/docs/en/userver/grpc/server_middlewares_implementation.md":"taxi/uservices/userver/scripts/docs/en/userver/grpc/server_middlewares_implementation.md",
   "scripts/docs/en/userver/http_server.md":"taxi/uservices/userver/scripts/docs/en/userver/http_server.md",
   "scripts/docs/en/userver/http_server_middlewares.md":"taxi/uservices/userver/scripts/docs/en/userver/http_server_middlewares.md",
   "scripts/docs/en/userver/intro.md":"taxi/uservices/userver/scripts/docs/en/userver/intro.md",

core/functional_tests/basic_chaos/static_config.yaml

@@ -84,14 +84,14 @@ components_manager:
                 port: 8188
                 task_processor: main-task-processor
 
-# /// logging
+# /// [logging]
         logging:
             fs-task-processor: fs-task-processor
             loggers:
                 default:
                     file_path: '@stderr'
                     level: info
-# /// logging
+# /// [logging]
 
         dynamic-config:
             updates-enabled: true

core/include/userver/components/state.hpp

@@ -53,7 +53,7 @@ enum class ServiceLifetimeStage {
     /// This stage starts after constructors for all components have completed without an exception.
     ///
     /// The order of `OnAllComponentsLoaded` hooks invocations respects the order of components defined
-    /// at @ref ServiceLifetimeStage::kComponentsLoading stage.
+    /// at @ref ServiceLifetimeStage::kLoading stage.
     kOnAllComponentsLoadedIsRunning,
 
     /// This stage marks that all `OnAllComponentsLoaded` hooks (as described
@@ -80,7 +80,7 @@ enum class ServiceLifetimeStage {
     /// @ref components::ComponentBase::OnLoadingCancelled for all constructed components.
     ///
     /// The order of `OnAllComponentsAreStopping` hooks invocations respects the order of components defined
-    /// at @ref ServiceLifetimeStage::kComponentsLoading stage (they run in the reverse-dependency order).
+    /// at @ref ServiceLifetimeStage::kLoading stage (they run in the reverse-dependency order).
     kOnAllComponentsAreStoppingIsRunning,
 
     /// Destructors are running for all components. This stage starts once
@@ -90,7 +90,7 @@ enum class ServiceLifetimeStage {
     /// after @ref ServiceLifetimeStage::kOnAllComponentsAreStoppingIsRunning for all constructed components.
     ///
     /// The order of destructor invocations respects the order of components defined
-    /// at @ref ServiceLifetimeStage::kComponentsLoading stage (they run in the reverse-dependency order).
+    /// at @ref ServiceLifetimeStage::kLoading stage (they run in the reverse-dependency order).
     kStopping,
 };
 

core/include/userver/engine/subprocess/process_starter.hpp

@@ -48,7 +48,7 @@ struct ExecOptions final {
 class ProcessStarter {
 public:
     /// @param task_processor will be used for executing asynchronous fork + exec.
-    /// `main-task-processor is OK for this purpose.
+    /// `main-task-processor` is OK for this purpose.
     explicit ProcessStarter(TaskProcessor& task_processor);
 
     /// @param executable_path the absolute path or relative path. If `use_path` is

core/include/userver/logging/component.hpp

@@ -54,11 +54,11 @@ namespace components {
 ///
 /// ### Logs output
 /// You can specify where logs are written in the `file_path` option:
-/// - Use `file_path: '@stdout'` to write your logs to standard output stream;
-/// - Use `file_path: '@stderr'` to write your logs to standard error stream;
-/// - Use `file_path: '@null'` to suppress sending of logs;
-/// - Use `file_path: /absolute/path/to/log/file.log` to write your logs to file. Use USR1 signal or @ref server::handlers::OnLogRotate to reopen files after log rotation;
-/// - Use `file_path: 'unix:/absolute/path/to/logs.sock'` to write your logs to unix socket. Socket must be created before the service starts and closed by listener after service is shut down.
+/// - Use <tt>file_path: '@stdout'</tt> to write your logs to standard output stream;
+/// - Use <tt>file_path: '@stderr'</tt> to write your logs to standard error stream;
+/// - Use <tt>file_path: '@null'</tt> to suppress sending of logs;
+/// - Use <tt>file_path: /absolute/path/to/log/file.log</tt> to write your logs to file. Use USR1 signal or @ref server::handlers::OnLogRotate to reopen files after log rotation;
+/// - Use <tt>file_path: 'unix:/absolute/path/to/logs.sock'</tt> to write your logs to unix socket. Socket must be created before the service starts and closed by listener after service is shut down.
 ///
 /// For sending logs directly to an otlp (opentelemetry) sink, see @ref opentelemetry.
 ///

core/include/userver/tracing/span.hpp

@@ -112,6 +112,7 @@ class Span final {
     ///
     /// @return A new Span that is the root of a new Span hierarchy.
     /// @param name Name of a new Span
+    /// @param source_location Implementation detail, do not touch.
     static Span MakeRootSpan(
         std::string name,
         const utils::impl::SourceLocation& source_location = utils::impl::SourceLocation::Current()

grpc/include/userver/ugrpc/client/middlewares/headers_propagator/component.hpp

@@ -14,7 +14,7 @@ namespace ugrpc::client::middlewares::headers_propagator {
 
 /// @ingroup userver_components userver_base_classes
 ///
-/// @brief The component for @ref ugrpc::client::middlewares::headers_propagator::Middleware.
+/// @brief gRPC client middleware for sending headers stored by the respective HTTP and gRPC server middlewares.
 ///
 /// ## Static options:
 /// Name | Description | Default value
@@ -26,8 +26,7 @@ namespace ugrpc::client::middlewares::headers_propagator {
 class Component final : public MiddlewareFactoryComponentBase {
 public:
     /// @ingroup userver_component_names
-    /// @brief The default name of
-    /// ugrpc::client::middlewares::headers_propagator::Component.
+    /// @brief The default name of ugrpc::client::middlewares::headers_propagator::Component.
     static constexpr std::string_view kName = "grpc-client-headers-propagator";
 
     Component(const components::ComponentConfig& config, const components::ComponentContext& context);

postgresql/include/userver/storages/postgres/cluster.hpp

@@ -100,6 +100,7 @@ class Cluster {
     /// @param ei_settings error injection settings
     /// @param testsuite_tasks see @ref testsuite::TestsuiteTasks
     /// @param config_source see @ref dynamic_config::Source
+    /// @param metrics metrics storage for alerts
     /// @param shard_number shard number
     /// @note When `max_connection_pool_size` is reached, and no idle connections
     /// available, `PoolError` is thrown for every new connection

samples/chaotic_openapi_service/testsuite/conftest.py

@@ -5,14 +5,12 @@
 USERVER_CONFIG_HOOKS = ['userver_config_client']
 
 
-# /// URL
+# /// [URL]
 @pytest.fixture(scope='session')
 def userver_config_client(mockserver_info):
     def do_patch(config_yaml, config_vars):
         components = config_yaml['components_manager']['components']
         components['test-client']['base-url'] = mockserver_info.url('test')
 
     return do_patch
-
-
-# /// URL
+    # /// [URL]

scripts/docs/doxygen.conf

@@ -1160,6 +1160,7 @@ EXAMPLE_PATH           = samples \
                          rabbitmq/functional_tests \
                          mysql/src \
                          mysql/functional_tests \
+                         mysql/tests \
                          sqlite/src \
                          sqlite/functional_tests \
                          ydb/src \