feat docs: update build options and task queue info

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

Author: apolukhin

.mapping.json

@@ -4491,6 +4491,7 @@
   "scripts/docs/en/userver/mysql/design_and_details.md":"taxi/uservices/userver/scripts/docs/en/userver/mysql/design_and_details.md",
   "scripts/docs/en/userver/mysql/mysql_driver.md":"taxi/uservices/userver/scripts/docs/en/userver/mysql/mysql_driver.md",
   "scripts/docs/en/userver/mysql/supported_types.md":"taxi/uservices/userver/scripts/docs/en/userver/mysql/supported_types.md",
+  "scripts/docs/en/userver/odbc.md":"taxi/uservices/userver/scripts/docs/en/userver/odbc.md",
   "scripts/docs/en/userver/os_signals.md":"taxi/uservices/userver/scripts/docs/en/userver/os_signals.md",
   "scripts/docs/en/userver/periodics.md":"taxi/uservices/userver/scripts/docs/en/userver/periodics.md",
   "scripts/docs/en/userver/pg_connlimit_mode_auto.md":"taxi/uservices/userver/scripts/docs/en/userver/pg_connlimit_mode_auto.md",

core/include/userver/components/manager_controller_component.hpp

@@ -62,7 +62,7 @@ class Manager;
 /// worker_threads | threads count for the task processor | -
 /// os-scheduling | OS scheduling mode for the task processor threads. 'idle' sets the lowest priority. 'low-priority' sets the priority below 'normal' but higher than 'idle'. | normal
 /// spinning-iterations | tunes the number of spin-wait iterations in case of an empty task queue before threads go to sleep | 1000
-/// task-processor-queue | Task queue mode for the task processor. `global-task-queue` default task queue. `work-stealing-task-queue` experimental with potentially better scalability than `global-task-queue`. | global-task-queue
+/// task-processor-queue | Task queue mode for the task processor. `global-task-queue` default task queue. `work-stealing-task-queue` experimental with potentially better scalability than `global-task-queue`. 'pull-pin-task-queue' - experimental queue where each task gets pinned to a thread-specific queue and is executed only in that thread. See also @ref engine::TaskQueueType | global-task-queue
 /// task-trace | optional dictionary of tracing options | empty (disabled)
 /// task-trace.every | set N to trace each Nth task | 1000
 /// task-trace.max-context-switch-count | set upper limit of context switches to trace for a single task | 1000

scripts/docs/en/index.md

@@ -177,6 +177,10 @@ and make sure that it builds and passes tests.
 * @ref scripts/docs/en/userver/sqlite/design_and_details.md
 
 
+## ODBC
+* @ref scripts/docs/en/userver/odbc.md
+
+
 ## Non relational databases
 * @ref scripts/docs/en/userver/mongodb.md
 * @ref scripts/docs/en/userver/redis.md

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

@@ -26,6 +26,8 @@ userver is split into multiple CMake libraries.
 | `userver::rabbitmq`        | `USERVER_FEATURE_RABBITMQ`                        | `rabbitmq`            | @ref rabbitmq_driver                                      |
 | `userver::mysql`           | `USERVER_FEATURE_MYSQL`                           | `mysql`               | @ref scripts/docs/en/userver/mysql/mysql_driver.md        |
 | `userver::rocks`           | `USERVER_FEATURE_ROCKS`                           | `rocks`               | TODO                                                      |
+| `userver::sqlite`          | `USERVER_FEATURE_SQLITE`                          | `sqlite`              | @ref scripts/docs/en/userver/sqlite/sqlite_driver.md      |
+| `userver::odbc`            | `USERVER_FEATURE_ODBC`                            | `odbc`                | @ref scripts/docs/en/userver/odbc.md                      |
 | `userver::ydb`             | `USERVER_FEATURE_YDB`                             | `ydb`                 | @ref scripts/docs/en/userver/ydb.md                       |
 | `userver::otlp`            | `USERVER_FEATURE_OTLP`                            | `otlp`                | @ref opentelemetry "OpenTelemetry Protocol"               |
 | `userver::s3api`           | `USERVER_FEATURE_S3API`                           | `s3api`               | @ref scripts/docs/en/userver/libraries/s3api.md           |
@@ -78,6 +80,8 @@ The exact format of setting cmake options varies depending on the method of buil
 | `USERVER_FEATURE_RABBITMQ`        | Provide asynchronous driver for RabbitMQ (AMQP 0-9-1)                             | `${USERVER_BUILD_ALL_COMPONENTS}`                           |
 | `USERVER_FEATURE_MYSQL`           | Provide asynchronous driver for MySQL/MariaDB                                     | `${USERVER_BUILD_ALL_COMPONENTS}`                           |
 | `USERVER_FEATURE_ROCKS`           | Provide asynchronous driver for RocksDB                                           | `${USERVER_BUILD_ALL_COMPONENTS}`                           |
+| `USERVER_FEATURE_SQLITE`          | Provide asynchronous driver for SQLite                                            | `${USERVER_BUILD_ALL_COMPONENTS}`                           |
+| `USERVER_FEATURE_ODBC`            | Provide asynchronous driver for ODBC                                              | `${USERVER_BUILD_ALL_COMPONENTS}`                           |
 | `USERVER_FEATURE_YDB`             | Provide asynchronous driver for YDB                                               | `${USERVER_BUILD_ALL_COMPONENTS}` AND C++ standard >= 20    |
 | `USERVER_FEATURE_OTLP`            | Provide Logger for OpenTelemetry protocol                                         | `${USERVER_BUILD_ALL_COMPONENTS}`                           |
 | `USERVER_FEATURE_GRPC_REFLECTION` | Provide reflection service for gRPC                                               | `${USERVER_BUILD_ALL_COMPONENTS}`                           |
@@ -188,7 +192,10 @@ The exact format of setting cmake options varies depending on the method of buil
 | `USERVER_CONAN`                        | Build userver using Conan packages                                                                         | `ON` if build is launched from Conan, `OFF` otherwise       |
 | `USERVER_CHAOTIC_FORMAT`               | Whether to format generated code if FORMAT option is missing                                               | `ON`                                                        |
 
-@warning Using LTO can lead to [some problems](https://github.com/userver-framework/userver/issues/242). We don't recommend using `USERVER_LTO`.
+@warning Using LTO can lead to [some problems](https://github.com/userver-framework/userver/issues/242). We don't
+         recommend using `USERVER_LTO` or consider using thread pinning schedulers (see @ref engine::TaskQueueType
+         for a list of queues and `task-processor-queue` static config option of
+         @ref components::ManagerControllerComponent for a ways to choose a queue).
 
 [tsan]: https://github.com/userver-framework/userver/blob/develop/cmake/tsan.suppressions.txt
 

scripts/docs/en/userver/mongodb.md

@@ -127,5 +127,5 @@ the service, then something is wrong with the database. Service or database main
 ----------
 
 @htmlonly <div class="bottom-nav"> @endhtmlonly
-⇦ @ref scripts/docs/en/userver/sqlite/design_and_details.md | @ref scripts/docs/en/userver/redis.md ⇨
+⇦ @ref scripts/docs/en/userver/odbc.md | @ref scripts/docs/en/userver/redis.md ⇨
 @htmlonly </div> @endhtmlonly

scripts/docs/en/userver/odbc.md

@@ -0,0 +1,11 @@
+## ODBC Driver
+
+🐙 **userver** provides generic asynchronous driver for SQL-like databases via ODBC. The driver is in early
+development stage and can only execute simple querries.
+
+
+----------
+
+@htmlonly <div class="bottom-nav"> @endhtmlonly
+⇦ @ref scripts/docs/en/userver/sqlite/design_and_details.md | @ref scripts/docs/en/userver/mongodb.md ⇨
+@htmlonly </div> @endhtmlonly

scripts/docs/en/userver/roadmap_and_changelog.md

@@ -50,17 +50,17 @@ Changelog news also go to the
 * 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.
+* @ref utils::statistics::RecentPeriod now does not lose precision under heavy contention.
 * 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
+* Fixed unnecessary lock in TaskContext destructor 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.
+* @ref scripts/docs/en/userver/gdb_debugging.md "Stack monitor usage" is now 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

scripts/docs/en/userver/sqlite/design_and_details.md

@@ -126,5 +126,5 @@ transaction.Rollback();
 ----------
 
 @htmlonly <div class="bottom-nav"> @endhtmlonly
-⇦ @ref scripts/docs/en/userver/sqlite/supported_types.md | @ref scripts/docs/en/userver/mongodb.md ⇨
+⇦ @ref scripts/docs/en/userver/sqlite/supported_types.md | @ref scripts/docs/en/userver/odbc.md ⇨
 @htmlonly </div> @endhtmlonly