feat docs: minor improvements for the documentation

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

Author: apolukhin

samples/redis_service/static_config.yaml

@@ -22,14 +22,6 @@ components_manager:
                 redis_thread_pool_size: 8
                 sentinel_thread_pool_size: 1
 
-# /// [Sample secdist static config]
-# yaml
-        default-secdist-provider:                        # Component that loads configuration of hosts and passwords
-            config: /etc/redis_service/secure_data.json  # Values are supposed to be stored in this file
-            missing-ok: true                             # ... but if the file is missing it is still ok
-            environment-secrets-key: SECDIST_CONFIG      # ... values will be loaded from this environment value
-# /// [Sample secdist static config]
-
         testsuite-support:
 
         server:
@@ -38,6 +30,14 @@ components_manager:
             listener:                 # configuring the main listening socket...
                 port: 8088            # ...to listen on this port and...
                 task_processor: main-task-processor    # ...process incoming requests on this task processor.
+
+        # /// [Sample secdist static config]
+        # yaml
+        default-secdist-provider:                        # Component that loads configuration of hosts and passwords
+            config: /etc/redis_service/secure_data.json  # Values are supposed to be stored in this file
+            missing-ok: true                             # ... but if the file is missing it is still ok
+            environment-secrets-key: SECDIST_CONFIG      # ... values will be loaded from this environment value
+        # /// [Sample secdist static config]
         logging:
             fs-task-processor: fs-task-processor
             loggers:

scripts/docs/en/index.md

@@ -151,14 +151,8 @@ are available at the
 * @ref clickhouse_driver
 
 ## Libraries
-
-### Easy
 * @ref scripts/docs/en/userver/libraries/easy.md
-
-### S3 client
 * @ref scripts/docs/en/userver/libraries/s3api.md
-
-### grpc-reflection
 * @ref scripts/docs/en/userver/libraries/grpc-reflection.md
 
 ## Opensource

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

@@ -269,7 +269,7 @@ To install userver in `ghcr.io/userver-framework/ubuntu-22.04-userver-base:lates
 sudo ./scripts/build_and_install_all.sh
 ```
 
-Alternatively see @ref userver_install
+Alternatively see @ref userver_install "userver install"
 
 @note The above image is build from `scripts/docker/ubuntu-22.04-pg.dockerfile`,
    `scripts/docker/ubuntu-22.04.dockerfile`

scripts/docs/en/userver/dynamic_config.md

@@ -269,7 +269,7 @@ Config defaults are specified in their
 @ref dynamic_config_key "C++ definition".
 They may be overridden in the static config of `dynamic-config` component:
 
-@see @ref dynamic_config_defaults_override
+@see @ref dynamic_config_defaults_override "Overriding dynamic configs defaults"
 
 If utils::DaemonMain is used, then the default dynamic configs can
 be printed by passing `--print-dynamic-config-defaults` command line option.
@@ -360,7 +360,8 @@ Here is a reasonable static config for those:
 Components components::DynamicConfigClientUpdater and components::DynamicConfigClient
 use the following OpenAPI Schema to communicate with the dynamic configs server:
 
-```yaml
+```
+# yaml
 swagger: '2.0'
 info:
     title: Dynamic configs service

scripts/docs/en/userver/libraries/grpc-reflection.md

@@ -1,9 +1,9 @@
-## grpc reflection
+## gRPC reflection
 
 **Quality:** @ref QUALITY_TIERS "Silver Tier".
 
-🐙 **userver** This library provides non-blocking implementation of reflection
-service. It is in fact an original implementation with a few modifications to
+This library provides non-blocking implementation of reflection
+service for gRPC in 🐙 **userver**. It is in fact an original implementation with a few modifications to
 replace all standard primitives with userver ones.
 
 

scripts/docs/en/userver/supported_platforms.md

@@ -30,6 +30,12 @@ organization page contains multiple repositories, including:
 * [service_template](https://github.com/userver-framework/service_template) -
   template of a C++ service that uses userver framework with ready-to-user
   build, test and CI scripts. 
+* [pg_service_template](https://github.com/userver-framework/pg_service_template) -
+  template of a C++ service that uses userver framework with ready-to-user PostgreSQL database,
+  build, test and CI scripts. 
+* [pg_grpc_service_template](https://github.com/userver-framework/pg_grpc_service_template) -
+  template of a C++ service that uses userver framework with ready-to-user PostgreSQL database, gRPC server,
+  build, test and CI scripts. 
 * [uservice-dynconf](https://github.com/userver-framework/uservice-dynconf) -
   the service to control dynamic configs of the other userver-based services.
 

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

@@ -80,6 +80,13 @@ Static configuration of service is quite close to the configuration from @ref sc
 
 @snippet samples/redis_service/static_config.yaml Redis service sample - static config
 
+components::Redis takes database connection information from components::DefaultSecdistProvider, so it should be
+also configured:
+
+@snippet samples/redis_service/static_config.yaml Sample secdist static config
+
+The actual content of `secure_data.json` or `SECDIST_CONFIG` is described at components::Redis.
+
 
 ### int main()
 
@@ -177,6 +184,9 @@ See the full example:
 * @ref samples/redis_service/redis_service.cpp
 * @ref samples/redis_service/static_config.yaml
 * @ref samples/redis_service/CMakeLists.txt
+* @ref samples/redis_service/testsuite/conftest.pysamples/redis_service/CMakeLists.txt
+* @ref samples/redis_service/testsuite/conftest.py
+* @ref samples/redis_service/testsuite/test_redis.py
 
 ----------
 
@@ -187,3 +197,5 @@ See the full example:
 @example samples/redis_service/redis_service.cpp
 @example samples/redis_service/static_config.yaml
 @example samples/redis_service/CMakeLists.txt
+@example samples/redis_service/testsuite/conftest.py
+@example samples/redis_service/testsuite/test_redis.py