dataroaring opened a new pull request, #3939: URL: https://github.com/apache/doris-website/pull/3939
## What - **Add a dedicated `Merge-on-Write` page** under Table Design › Data Model, as the single canonical source for how the merge-on-write and merge-on-read implementations work, their read/write trade-offs, how to choose, and how to enable each. - **Rewrite the `Unique Key Model` page to be task-first**: it now leads with `CREATE TABLE` and an upsert example, then links to the new page for the underlying mechanism. The merge-on-write / merge-on-read architecture explanation that previously sat between the intro and the first runnable example has moved to the new page. ## Why On the current Unique Key Model page, a reader who just wants to create a unique-key table has to read the "How It Works" implementation comparison and the update-semantics tables before reaching the first `CREATE TABLE`. The merge-on-write mechanism is also re-explained inline across many loading and update pages, with no canonical home to link to. Separating the explanation (merge-on-write) from the how-to (creating and upserting a unique-key table) follows the Diátaxis split: the task page gets you to a runnable example quickly, and the concept page can be linked from everywhere merge-on-write is referenced. ## Scope - English only. - Applies to both the current docs (`docs/`) and `versioned_docs/version-4.x`; both sidebars updated. - New doc id: `table-design/data-model/merge-on-write`, placed right after `unique` in the Table Models category. ## Validation - `version-4.x-sidebars.json` parses as valid JSON. - Cross-link targets (`data-operate/update/update-of-unique-model`) and the referenced image exist in both trees. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
