feat docs: fix typos and Doxygen markup

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

Author: apolukhin

core/src/logging/log_test.cpp

@@ -100,25 +100,21 @@ TEST_F(LoggingTest, DocsData) {
 }
 
 TEST_F(LoggingTest, DocsDataInline) {
-    /// [Sample logging usage]
     LOG_TRACE("Very verbose logs, only enabled using dynamic debug logs");
     LOG_DEBUG("Some debug info, not logged by default in production");
     LOG_INFO("This is informational message");
     LOG_WARNING("Something strange happened");
     LOG_ERROR("This is unbelievable, fix me, please!");
     LOG_CRITICAL("The service is about to abort, bye");
-    /// [Sample logging usage]
 }
 
 TEST_F(LoggingTest, DocsDataInlineFormat) {
-    /// [Sample logging usage]
     LOG_TRACE("Very {} logs, only enabled using dynamic debug logs", "verbose");
     LOG_DEBUG("Some {} info, not logged by default in production", "debug");
     LOG_INFO("This is {} message", "informational");
     LOG_WARNING("Something {} happened", "strange");
     LOG_ERROR("This is {}, fix me, please!", "unbelievable");
     LOG_CRITICAL("The service is about to {}, bye", "abort");
-    /// [Sample logging usage]
 
     // NOTE: Should not be compilable!
     // LOG_WARNING(fmt::format("Something {} happened", "strange"));
@@ -248,20 +244,18 @@ TEST_F(LoggingTest, LoggingNestedStructures) {
         }
         out << "]";
     };
-    /// [Example Logging Nested Structures]
     EXPECT_EQ("Records: [{foo=1, bar=x}, {foo=2, bar=y}, ]", LoggedText());
-
     ClearLog();
-    /// [Example Logging Nested Structures]
+
     LOG_INFO() << [&list](auto& out) {
         out << "Records: [";
         for (const auto& item : list) {
             out.Format("{{foo={}, bar={}}}, ", item.foo, item.bar);
         }
         out << "]";
     };
-    /// [Example Logging Nested Structures]
     EXPECT_EQ("Records: [{foo=1, bar=x}, {foo=2, bar=y}, ]", LoggedText());
+    /// [Example Logging Nested Structures]
 }
 
 USERVER_NAMESPACE_END

libraries/grpc-protovalidate/include/userver/grpc-protovalidate/buf_validate.hpp

@@ -1,6 +1,6 @@
 #pragma once
 
-/// @file userver/grpc-protovalidate/buf_validate.hpp
+/// @file
 /// @brief Header which wraps @c buf/validate/validator.h to suppress compiler
 ///        warnings from it.
 

libraries/grpc-protovalidate/include/userver/grpc-protovalidate/client/component.hpp

@@ -1,6 +1,6 @@
 #pragma once
 
-/// @file userver/grpc-protovalidate/client/component.hpp
+/// @file
 /// @brief @copybrief grpc_protovalidate::client::ValidatorComponent
 
 #include <userver/ugrpc/client/middlewares/base.hpp>

libraries/grpc-protovalidate/include/userver/grpc-protovalidate/client/exceptions.hpp

@@ -1,6 +1,6 @@
 #pragma once
 
-/// @file userver/grpc-protovalidate/client/component.hpp
+/// @file
 /// @brief Exceptions thrown by gRPC client validator middleware
 
 #include <userver/grpc-protovalidate/buf_validate.hpp>

libraries/grpc-protovalidate/include/userver/grpc-protovalidate/server/component.hpp

@@ -1,6 +1,6 @@
 #pragma once
 
-/// @file userver/grpc-protovalidate/server/component.hpp
+/// @file
 /// @brief @copybrief grpc_protovalidate::server::ValidatorComponent
 
 #include <userver/ugrpc/server/middlewares/base.hpp>

scripts/docs/doxygen.conf

@@ -193,6 +193,7 @@ STRIP_FROM_PATH        = universal/include \
                          ydb/include \
                          libraries/easy/include \
                          libraries/s3api/include \
+                         libraries/grpc-protovalidate/include \
                          libraries/grpc-reflection/include \
                          scripts/docs
 
@@ -222,6 +223,7 @@ STRIP_FROM_INC_PATH    = universal/include \
                          ydb/include \
                          libraries/easy/include \
                          libraries/s3api/include \
+                         libraries/grpc-protovalidate/include \
                          libraries/grpc-reflection/include \
                          scripts/docs
 

scripts/docs/en/userver/functional_testing.md

@@ -445,7 +445,7 @@ For metrics with labels, they could be retrieved in the following way:
 The @ref pytest_userver.metrics.Metric "Metric" python type is hashable and
 comparable:
 
-@snippet testsuite/tests/test_metrics.py  values set
+@snippet testsuite/tests/metrics/test_metrics.py  values set
 
 * C++ code: @ref samples/testsuite-support/src/metrics.cpp
 * C++ header: @ref samples/testsuite-support/src/metrics.hpp

scripts/docs/en/userver/roadmap_and_changelog.md

@@ -1365,7 +1365,7 @@ Detailed descriptions could be found below.
     more info.
   * Scripts for generating CMakeLists were simplified and cleared from internal
     stuff.
-  * Added missing dependencies to @ref scripts/docs/en/deps/ubuntu-20.04.md and sorted all
+  * Added missing dependencies to Ubuntu-20.04 and sorted all
     the dependencies, thanks to [Anatoly Shirokov](https://github.com/anatoly-spb)
     for the PR.
 * Statistics and metrics now do additional lifetime checks in debug builds to

testsuite/pytest_plugins/pytest_userver/metrics.py

@@ -37,7 +37,7 @@ class Histogram:
     Represents the value of a HIST_RATE (a.k.a. Histogram) metric.
 
     Usage example:
-    @snippet testsuite/tests/test_metrics.py  histogram
+    @snippet testsuite/tests/metrics/test_metrics.py  histogram
 
     Normally obtained from MetricsSnapshot
     """
@@ -73,7 +73,7 @@ class Metric:
     `value: int`.
 
     The type is hashable and comparable:
-    @snippet testsuite/tests/test_metrics.py  values set
+    @snippet testsuite/tests/metrics/test_metrics.py  values set
 
     @ingroup userver_testsuite
     """