Copilot commented on code in PR #3470:
URL: https://github.com/apache/doris-website/pull/3470#discussion_r2940369046
##########
i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/gettingStarted/before-you-start-the-poc.md:
##########
@@ -0,0 +1,115 @@
+---
+{
+ "title": "POC 前必读",
+ "language": "zh-CN",
+ "description": "新用户在 Apache Doris 建表设计、数据导入和查询调优中常见的问题。",
+ "sidebar_label": "POC 前必读"
+}
+---
+
+# POC 前必读
+
+本文档汇总了新用户常见的问题，旨在加速 POC 进程。
+
+## 建表设计
+
+在 Doris 中建表涉及四个影响导入和查询性能的决策。
+
+### 数据模型
+
+| 数据特征 | 使用 | 原因 |
+|---|---|---|
+| 仅追加（日志、事件、事实表） | **Duplicate Key**（默认） | 保留所有行。查询性能最好。 |
+| 按主键更新（CDC、Upsert） | **Unique Key** | 新行按相同 Key 替换旧行。 |
+| 预聚合指标（PV、UV、汇总） | **Aggregate Key** | 写入时按 SUM/MAX/MIN 合并行。 |
Review Comment:
Same as the EN version: starting table rows with `||` commonly renders as an
unintended empty first column. Switch to a single leading `|` and keep column
separators consistent so the table renders correctly. This also appears in the
3.x zh-CN copy.
##########
versioned_docs/version-4.x/gettingStarted/before-you-start-the-poc.md:
##########
@@ -0,0 +1,115 @@
+---
+{
+ "title": "Before You Start the POC",
+ "language": "en",
+ "description": "Common issues new users encounter with table design, data
loading, and query tuning in Apache Doris.",
+ "sidebar_label": "Before You Start the POC"
+}
+---
+
+# Before You Start the POC
+
+This document highlights common issues that new users may encounter, with the
goal of accelerating the POC process.
+
+## Table Design
+
+Creating a table in Doris involves four decisions that affect load and query
performance.
+
+### Data Model
+
+| If your data is... | Use | Why |
+|---|---|---|
+| Append-only (logs, events, facts) | **Duplicate Key** (default) | Keeps all
rows. Best query performance. |
+| Updated by primary key (CDC, upsert) | **Unique Key** | New rows replace old
rows with the same key. |
+| Pre-aggregated metrics (PV, UV, sums) | **Aggregate Key** | Rows are merged
with SUM/MAX/MIN at write time. |
Review Comment:
The table rows start with `||`, which Markdown typically interprets as an
empty first column (resulting in a visually broken/misaligned table). Use a
single leading `|` (and a consistent number of separators) to produce a
3-column table. This same formatting appears in the 3.x copy of this doc as
well.
--
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]
