Fixes

Author: shnikd

ydb/docs/en/core/yql/reference/syntax/alter-sequence.md

@@ -47,7 +47,7 @@ ALTER SEQUENCE `/Root/users/_serial_column_user_id`
     RESTART 1000;
 ```
 
-An alternative way to achieve the same result is to first change the start value, and then `RESTART` the `Sequence`. After this, subsequent calls to `RESTART` without an explicit value will set the current value to 1000:
+An alternative way to change the current value is to first set a new start value, and then `RESTART` the `Sequence`. After this, subsequent calls to `RESTART` without an explicit value will set the current value to 1000:
 
 ```yql
 ALTER SEQUENCE `/Root/users/_serial_column_user_id` INCREMENT BY 5 START WITH 1000;

ydb/docs/en/core/yql/reference/types/serial.md

@@ -10,11 +10,11 @@ At present, the `Sequence` object supports several parameters that determine its
 
 By default, values generated by the `Sequence` start from one, are incremented by one with each new value, and are limited according to the chosen type.
 
-> **Note:**
-> Serial columns are supported both for columns included in the primary key and for non-key columns.
->
-> However, such columns cannot be [altered](../syntax/alter_table/family#mod-column-groups) or [dropped](../syntax/alter_table/columns.md) from the table —
-> attempting to perform these operations will result in an error.
+{% note info %}
+Serial columns are supported both for columns included in the primary key and for non-key columns.
+
+However, such columns cannot be [altered](../syntax/alter_table/family#mod-column-groups) or [dropped](../syntax/alter_table/columns.md) from the table — attempting to perform these operations will result in an error.
+{% endnote %}
 
 | Type        | Maximum Value         | YDB Type |
 |-------------|----------------------|----------|
@@ -32,8 +32,10 @@ Error: Failed to get next val for sequence: /dev/test/users/_serial_column_user_
     <main>: Error: sequence [OwnerId: <some>, LocalPathId: <some>] doesn't have any more values available, code: 200503
 ```
 
-**Note:** The next value is allocated by the generator before the actual insertion into the table and is considered used even if the row is not successfully inserted (for example, in case of transaction rollback).
+{% note info %}
+The next value is allocated by the generator before the actual insertion into the table and is considered used even if the row is not successfully inserted (for example, in case of transaction rollback).
 As a result, the values in such a column may have gaps and may not form a continuous sequence.
+{% endnote %}
 
 Tables with `Serial` columns support [copy](../../../reference/ydb-cli/tools-copy.md), [rename](../../../reference/ydb-cli/commands/tools/rename.md), [dump](../../../reference/ydb-cli/export-import/tools-dump.md), [restore](../../../reference/ydb-cli/export-import/import-file.md), and [import](../../../reference/ydb-cli/export-import/import-s3.md)/[export](../../../reference/ydb-cli/export-import/export-s3.md) operations.
 

ydb/docs/ru/core/yql/reference/types/serial.md

@@ -11,11 +11,11 @@
 
 По умолчанию генерируемые значения начинаются с единицы, увеличиваются на один при каждом новом значении и ограничены в соответствии с выбранным типом.
 
-> **Примечание:**
-> Колонки типа `Serial` поддерживаются как для колонок, входящих в состав первичного ключа, так и для неключевых колонок.
->
-> Однако такие колонки нельзя [изменить](../syntax/alter_table/family#mod-column-groups) или [удалить](../syntax/alter_table/columns.md) из таблицы —
-> при попытке выполнить эти операции будет возвращена ошибка.
+{% note info %}
+Колонки типа `Serial` поддерживаются как для колонок, входящих в состав первичного ключа, так и для неключевых колонок.
+
+Однако такие колонки нельзя [изменить](../syntax/alter_table/family#mod-column-groups) или [удалить](../syntax/alter_table/columns.md) из таблицы — при попытке выполнить эти операции будет возвращена ошибка.
+{% endnote %}
 
 | Тип           | Максимальное значение | Тип значения |
 |---------------|-----------------------|--------------|
@@ -33,7 +33,9 @@ Error: Failed to get next val for sequence: /dev/test/users/_serial_column_user_
     <main>: Error: sequence [OwnerId: <some>, LocalPathId: <some>] doesn't have any more values available, code: 200503
 ```
 
-Отметим, что следующее значение выдаётся генератором до непосредственной вставки в таблицу и уже будет считаться использованным, даже если строка, содержащая это значение, не была успешно вставлена, например, при откате транзакции. Поэтому множество значений такой колонки может содержать пропуски и состоять из нескольких промежутков.
+{% note info %}
+Cледующее значение выдаётся генератором до непосредственной вставки в таблицу и уже будет считаться использованным, даже если строка, содержащая это значение, не была успешно вставлена, например, при откате транзакции. Поэтому множество значений такой колонки может содержать пропуски и состоять из нескольких промежутков.
+{% endnote %}
 
 Для таблиц с автоинкрементными колонками поддержаны операции [copy](../../../reference/ydb-cli/tools-copy.md), [rename](../../../reference/ydb-cli/commands/tools/rename.md), [dump](../../../reference/ydb-cli/export-import/tools-dump.md), [restore](../../../reference/ydb-cli/export-import/import-file.md) и [import](../../../reference/ydb-cli/export-import/import-s3.md)/[export](../../../reference/ydb-cli/export-import/export-s3.md).
 
@@ -90,5 +92,5 @@ CREATE TABLE users_bad (
 );
 ```
 
-В следующем примере автоинкрементная колонка является единственным и первым элементом ключа — это приведёт к неравномерной нагрузке и узкому месту на последней партиции.
+В этом примере автоинкрементная колонка является единственным и первым элементом ключа — это приведёт к неравномерной нагрузке и узкому месту на последней партиции.