Error Report
- What is the URL/path of the document related to this issue?
- How would you like to improve it?
In the "Configure parameters" section, under "v2.0.5 and later", this sentence is hard to parse:
If the upstream MySQL/MariaDB (at the same time) uses the gh-ost or pt-osc tool, set online-ddl to true in the task configuration file:
The parenthetical "(at the same time)" doesn't clearly attach to anything else in the sentence, and it's unclear what it's meant to convey — e.g., whether it means "concurrently with DM's replication task", "using both gh-ost and pt-osc simultaneously" (which would be odd given the very next words are "or"), or something else. By contrast, the parallel sentence in the "earlier than v2.0.5" tab right below has no such parenthetical:
If the upstream MySQL/MariaDB uses the gh-ost tool, set it in the task configuration file:
I checked the Chinese source (docs-cn, same file/branch) and the same parenthetical is present there too (如上游 MySQL/MariaDB **(同时)**使用 gh-ost 或 pt-osc 工具), so this isn't an EN-translation-introduced issue — it traces back to the original Chinese wording. Could someone familiar with the original intent clarify what "(at the same time)"/"(同时)" is meant to express here, so the sentence can be reworded more clearly (or the parenthetical removed if it isn't adding real meaning)?
(Found while reviewing the Japanese translation of this file, which faithfully mirrors this same ambiguity from the English/Chinese source — so this is a source-content clarity issue, not a translation defect.)
Error Report
dm/dm-online-ddl-tool-support.md, also present onrelease-8.5)In the "Configure parameters" section, under "v2.0.5 and later", this sentence is hard to parse:
The parenthetical "(at the same time)" doesn't clearly attach to anything else in the sentence, and it's unclear what it's meant to convey — e.g., whether it means "concurrently with DM's replication task", "using both gh-ost and pt-osc simultaneously" (which would be odd given the very next words are "or"), or something else. By contrast, the parallel sentence in the "earlier than v2.0.5" tab right below has no such parenthetical:
I checked the Chinese source (
docs-cn, same file/branch) and the same parenthetical is present there too (如上游 MySQL/MariaDB **(同时)**使用 gh-ost 或 pt-osc 工具), so this isn't an EN-translation-introduced issue — it traces back to the original Chinese wording. Could someone familiar with the original intent clarify what "(at the same time)"/"(同时)" is meant to express here, so the sentence can be reworded more clearly (or the parenthetical removed if it isn't adding real meaning)?(Found while reviewing the Japanese translation of this file, which faithfully mirrors this same ambiguity from the English/Chinese source — so this is a source-content clarity issue, not a translation defect.)