Skip to content

Conversation

avpershin
Copy link
Collaborator

Changelog entry

Reorder the description of transaction modes by strictness

Changelog category

  • Documentation (changelog entry is not required)

Description for reviewers

There is a page in the YDB documentation, which describes the transaction modes.

https://ydb.tech/docs/ru/concepts/transactions#modes

This section starts with mentioning the Serializable mode (the strictest mode) and then describes other modes, but the other modes are described in essentially random order, which makes it hard to read and to understand their logic. This change reorders the descriptions so that the modes are described in the order of reduced strictness (from the most strict to the least strict mode). This makes it easier to understand which guarantee is "removed" from the previous mode and which performance characteristics are "gained" from the previous mode.

For comparison, the SQL isolation levels on the official Wikipedia page are also listed in the order of reduced strictness.

https://en.wikipedia.org/wiki/Isolation_(database_systems)#Isolation_levels

NOTE: There are no changes to the actual description of the modes. Only the order is changed.

@avpershin avpershin requested a review from a team as a code owner September 12, 2025 11:40
@github-actions github-actions bot added the documentation Improvements or additions to documentation label Sep 12, 2025
Copy link

🟢 2025-09-12 11:43:26 UTC The validation of the Pull Request description is successful.

@avpershin avpershin force-pushed the YDBDOCS-1337-reorder-transaction-modes branch from 5abe8c2 to d91c27f Compare September 12, 2025 11:52
Copy link

github-actions bot commented Sep 12, 2025

2025-09-12 11:54:29 UTC Pre-commit check linux-x86_64-relwithdebinfo for 4ebfbbd has started.
2025-09-12 11:54:56 UTC Artifacts will be uploaded here
2025-09-12 11:57:53 UTC ya make is running...
🟢 2025-09-12 11:57:59 UTC Tests successful.

Test history | Ya make output | Test bloat

TESTS PASSED ERRORS FAILED SKIPPED MUTED?
0 0 0 0 0 0

🟢 2025-09-12 11:58:05 UTC Build successful.

Copy link

✅ Documentation build

Revision built successfully
Revision preview link

Build logs

Warnings (2)

⚠️ ru/yql/reference/syntax/alter-transfer.md: 14: MD051 / link-fragments Link fragments should be valid [Context: "lambda-функция"]

⚠️ ru/yql/reference/syntax/create-transfer.md: 16: MD051 / link-fragments Link fragments should be valid [Context: "lambda-функция"]

@ydbot
Copy link
Collaborator

ydbot commented Sep 12, 2025

🔄 New commits pushed — @a-s-maslov please take a look.

Copy link

github-actions bot commented Sep 12, 2025

2025-09-12 11:55:27 UTC Pre-commit check linux-x86_64-release-asan for 4ebfbbd has started.
2025-09-12 11:56:02 UTC Artifacts will be uploaded here
2025-09-12 11:59:01 UTC ya make is running...
🟢 2025-09-12 11:59:06 UTC Tests successful.

Test history | Ya make output | Test bloat

TESTS PASSED ERRORS FAILED SKIPPED MUTED?
0 0 0 0 0 0

🟢 2025-09-12 11:59:13 UTC Build successful.

Copy link

✅ Documentation build

Revision built successfully
Revision preview link

Build logs

Warnings (2)

⚠️ ru/yql/reference/syntax/alter-transfer.md: 14: MD051 / link-fragments Link fragments should be valid [Context: "lambda-функция"]

⚠️ ru/yql/reference/syntax/create-transfer.md: 16: MD051 / link-fragments Link fragments should be valid [Context: "lambda-функция"]

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants