diff --git a/ydb/docs/en/core/yql/reference/syntax/_includes/index_grammar_explanation.md b/ydb/docs/en/core/yql/reference/syntax/_includes/index_grammar_explanation.md
index 123a935cd1c6..c1a635059015 100644
--- a/ydb/docs/en/core/yql/reference/syntax/_includes/index_grammar_explanation.md
+++ b/ydb/docs/en/core/yql/reference/syntax/_includes/index_grammar_explanation.md
@@ -4,8 +4,12 @@
     * `LOCAL` — a local index within a shard of a row-oriented or column-oriented table. Does not require distributed transactions for updates, but does not provide pruning during search.
 
 * `<index_name>` — unique index name that will be used to access data.
-* `SYNC/ASYNC` — synchronous or asynchronous writes to the index, synchronous by default.
-* `<index_type>` - index type, currently supported:
+* `SYNC/ASYNC` — the index synchronization mode.
+
+    * `SYNC` — a [synchronous](../../../../concepts/secondary_indexes.md#sync) index. This is the default value.
+    * `ASYNC` — an [asynchronous](../../../../concepts/secondary_indexes.md#async) index.
+
+* `<index_type>` — index type, currently supported:
 
     * `secondary` — secondary index. Only `GLOBAL` is available. This is the default value.
     * `vector_kmeans_tree` — vector index. Described in detail in [{#T}](../create_table/vector_index.md).
diff --git a/ydb/docs/ru/core/yql/reference/syntax/_includes/index_grammar_explanation.md b/ydb/docs/ru/core/yql/reference/syntax/_includes/index_grammar_explanation.md
index c8096a7b5322..6e3dbb8700b6 100644
--- a/ydb/docs/ru/core/yql/reference/syntax/_includes/index_grammar_explanation.md
+++ b/ydb/docs/ru/core/yql/reference/syntax/_includes/index_grammar_explanation.md
@@ -4,7 +4,11 @@
     * `LOCAL` — локальный индекс в рамках шарда колоночной или строковой таблицы, не требует распределённых транзакций при обновлении, однако не обеспечивает прюнинг при поиске.
 
 * `<index_name>` — уникальное имя индекса, по которому будет возможно обращение к данным.
-* `SYNC/ASYNC` — синхронная или асинхронная запись в индекс. По умолчанию синхронная.
+* `SYNC/ASYNC` — признак синхронности индекса.
+
+    * `SYNC` - [синхронный](../../../../concepts/secondary_indexes.md#sync) индекс. Значение по умолчанию.
+    * `ASYNC` - [асинхронный](../../../../concepts/secondary_indexes.md#async) индекс.
+
 * `<index_type>` - тип индекса, в настоящее время поддерживаются:
 
     * `secondary` — вторичный индекс. Доступен только `GLOBAL`. Является значением по умолчанию.