Skip to content

Unclear parenthetical "(at the same time)" in dm-online-ddl-tool-support.md #23829

Description

@yahonda

Error Report

  1. What is the URL/path of the document related to this issue?
  1. 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.)

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions