zhangshenghang opened a new pull request, #13019: URL: https://github.com/apache/seatunnel/pull/13019
I acknowledge that I am contributing to Apache SeaTunnel, and thank the community for reviewing this documentation fix. ## What documentation issues were found A systematic comparison of every `docs/en` page against its `docs/zh` counterpart (section-heading structural diff, plus option-table, link, and anchor validation against the source code) found that several Chinese documentation pages were missing whole sections that exist in the English documentation. Readers of the Chinese docs could not access this content at all — including option behavior explanations, working configuration examples, and documented limitations. ## What was changed All changes are on the Chinese (`docs/zh`) side, adding the missing content translated from the authoritative English pages. No English content was changed, and no code was touched. - `docs/zh/connectors/sink/StarRocks.md`: added the missing `CDC 与 Schema 变更`, `MySQL-CDC 与定时刷新`, and `多表` (example1/example2) example sections. - `docs/zh/connectors/sink/Prometheus.md`: added the missing `流式 Remote Write 与批量刷新` and `多表 Remote Write` sections. - `docs/zh/connectors/source/InfluxDB.md`: added the missing `where [string]` reserved-option explanation and the `有界读取与并行切分` example. - `docs/zh/connectors/sink/SensorsData.md`: added the missing `用户明细（Detail 记录）` and `多身份与动态事件名称` example sections. - `docs/zh/connectors/source/Intercom.md`: added the missing `api_key` and `retry` option detail sections. - `docs/zh/connectors/source/Typeform.md`: added the missing `api_key`, `since / until / response_type`, and `retry` option detail sections (and removed the now-duplicated prose). - `docs/zh/introduction/concepts/config.md`: restored the three `###` sub-headings (`变量使用方法` / `示例` / `注意事项`) in the config-variable-substitution section to match the English structure. - `docs/zh/architecture/features/multi-table.md`: added the missing `11. 限制与注意事项` and `12. 后续增强` sections (shared-parallelism / fixed-replica / memory-overhead limitations and workarounds, dynamic and adaptive replicas). - `docs/zh/architecture/api-design/catalog-table.md`: added the missing `11. 参考资料` / `关键源码文件` section. - `docs/zh/architecture/api-design/sink-architecture.md`: restored the missing `3. 关键实现` / `3.1 SinkWriter 接口` headings around the existing SinkWriter content, whose absence made the section numbering jump from 2.3 to 3.2, and added the missing `3.4 代码参考` section. - `docs/zh/architecture/api-design/translation-layer.md`: added the missing `10. 参考资料` section with key source files and further reading. ## Which areas/files were updated 11 files under `docs/zh/`: 6 connector pages (StarRocks sink, Prometheus sink, InfluxDB source, SensorsData sink, Intercom source, Typeform source), 1 concepts page (config), and 4 architecture pages (multi-table, catalog-table, sink-architecture, translation-layer). 523 lines added, 5 removed. ## Were English and Chinese docs both checked? Yes. The two languages were compared page by page with a section-structure diff across the whole `docs/` tree. After the fix, all six connector pages have exactly the same section structure as their English counterparts. Pages where the Chinese version intentionally diverges (e.g., the adapted multi-table Source-architecture narrative) or where both languages are already complete were deliberately left untouched. ## How duplicate PRs from the last 7 days were checked I reviewed all docs PRs opened or merged in the last 7 days: #12993 (HTTP-based connectors, CDC, sink docs), #12986 (JDBC dialect, Kafka, SQL functions), #12971 (engine, CDC, file, SaaS connectors), #12951/#12941/#12932 (merged), #12865 and #12813 (connector docs), and #12981 (FieldMapper). None of them touches any of the 11 files modified here — the overlap check was done by comparing changed file paths of each PR against this PR's file set. This PR also intentionally avoids every file modified by those still-open PRs to prevent conflicts. ## How the change was verified - Section-structure diff (heading count and sequence) re-run after the fix: all modified connector pages now match the English section counts exactly (e.g., StarRocks 30→35, Prometheus 13→15, InfluxDB 26→28, SensorsData 34→36, Intercom 6→8, Typeform 6→9). - Full-tree relative-link and heading-anchor validation (including code fences, inline triple backticks, and explicit `<a id>` anchors): 0 broken links and 0 broken anchors across `docs/en` and `docs/zh`, including all links added by this PR. - The repository has no dedicated docs CI workflow (verified under `.github/workflows/`), so a full Docusaurus production build was not run; the custom link/anchor/structure checks above are the docs verification for this change. -- 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]
