[docs] extra comment about recommended node count for cluster topologies (#14358)

2 files changed, 9 insertions, 5 deletions

diff --git a/ydb/docs/en/core/concepts/topology.md b/ydb/docs/en/core/concepts/topology.md
index f4526c61f6e..7b4394ee612 100644
--- a/ydb/docs/en/core/concepts/topology.md
+++ b/ydb/docs/en/core/concepts/topology.md
@@ -28,10 +28,10 @@ Fault-tolerant operation modes of distributed storage require a significant amou
 
 | Mode | Storage<br>volume multiplier | Minimum<br>number<br>of nodes | Fail<br>domain | Fail<br>realm | Number of<br>data centers | Number of<br>server racks |
 | --- | --- | --- | --- | --- | --- | --- |
-| `mirror-3-dc`, can stand a failure of a data center and 1 rack in one of the remaining data centers | 3 | 9 (12 recommended) | Rack | Data center | 3 | 3 in each data center |
+| `mirror-3-dc`, can stand a failure of a data center and 1 rack in one of the remaining data centers | 3 | 9 ([12 recommended](*recommended-node-count)) | Rack | Data center | 3 | 3 in each data center |
 | `mirror-3-dc` *(reduced)*, can stand a failure of a data center and 1 server in one of the two other data centers | 3 | 12 | ½ a rack | Data center | 3 | 6 |
 | `mirror-3-dc` *(3 nodes)*, can stand a failure of a single server, or a failure of a data center | 3 | 3 | Server | Data center | 3 | Doesn't matter |
-| `block-4-2`, can stand a failure of 2 racks | 1.5 | 8 (10 recommended) | Rack | Data center | 1 | 8 |
+| `block-4-2`, can stand a failure of 2 racks | 1.5 | 8 ([10 recommended](*recommended-node-count)) | Rack | Data center | 1 | 8 |
 | `block-4-2` *(reduced)*, can stand a failure of 1 rack | 1.5 | 10 | ½ a rack | Data center | 1 | 5 |
 | `none`, no fault tolerance | 1 | 1 | Node | Node | 1 | 1 |
 
@@ -87,4 +87,6 @@ To survive an entire data center outage at the database level, assuming a cluste
 * [Documentation for DevOps Engineers](../devops/index.md)
 * [{#T}](../reference/configuration/index.md#domains-blob)
 * [Example cluster configuration files](https://github.com/ydb-platform/ydb/tree/main/ydb/deploy/yaml_config_examples/)
-* [{#T}](../contributor/distributed-storage.md)
\ No newline at end of file
+* [{#T}](../contributor/distributed-storage.md)
+
+[*recommended-node-count]: Using fewer than this number of nodes will limit the cluster's ability to [self-heal](../maintenance/manual/selfheal.md).
\ No newline at end of file
diff --git a/ydb/docs/ru/core/concepts/topology.md b/ydb/docs/ru/core/concepts/topology.md
index 77834acf347..e08c870b004 100644
--- a/ydb/docs/ru/core/concepts/topology.md
+++ b/ydb/docs/ru/core/concepts/topology.md
@@ -26,10 +26,10 @@
 
 | Режим | Множитель<br/>объёма<br/>хранения | Минимальное<br/>количество<br/>узлов | Домен<br/>отказа | Область<br/>отказа | Кол-во<br/>дата-центров | Кол-во<br/>серверных<br/>стоек |
 | --- | --- | --- | --- | --- | --- | --- |
-| `mirror-3-dc`, переживает отказ дата-центра и ещё 1 стойки в оставшихся дата-центрах | 3 | 9 (12 рекомендовано) | Стойка | Дата-центр | 3 | 3 в каждом дата-центре |
+| `mirror-3-dc`, переживает отказ дата-центра и ещё 1 стойки в оставшихся дата-центрах | 3 | 9 ([12 рекомендовано](*recommended-node-count)) | Стойка | Дата-центр | 3 | 3 в каждом дата-центре |
 | `mirror-3-dc` *(упрощённый)*, переживает отказ дата-центра и ещё 1 сервера в оставшихся дата-центрах | 3 | 12 | ½ стойки | Дата-центр | 3 | 6 |
 | `mirror-3-dc` *(3 узла)*, переживает отказ 1 узла или 1 дата-центра | 3 | 3 | Сервер | Дата-центр | 3 | Не важно |
-| `block-4-2`, переживает отказ 2 стоек | 1.5 | 8 (10 рекомендовано) | Стойка | Дата-центр | 1 | 8 |
+| `block-4-2`, переживает отказ 2 стоек | 1.5 | 8 ([10 рекомендовано](*recommended-node-count)) | Стойка | Дата-центр | 1 | 8 |
 | `block-4-2` *(упрощённый)*, переживает отказ 1 стойки | 1.5 | 10 | ½ стойки | Дата-центр | 1 | 5 |
 | `none`, избыточность отсутствует | 1 | 1 | Узел | Узел | 1 | 1 |
 
@@ -88,3 +88,5 @@
 {% if audience != "corp" %}
 * [{#T}](../contributor/distributed-storage.md)
 {% endif %}
+
+[*recommended-node-count]: Использование меньшего количества узлов приведёт к ограничению способности кластера к [автоматическому восстановлению](../maintenance/manual/selfheal.md).
\ No newline at end of file