Skip to content

docs: zh/10–20 校准·逐句复审·跨版本一致化系列(41 commits) - #2

Open
Vonng wants to merge 41 commits into
pg/audit-toolingfrom
pg/zh10-20-review-series
Open

Vonng wants to merge 41 commits into
pg/audit-toolingfrom
pg/zh10-20-review-series

Conversation

@Vonng

@Vonng Vonng commented Sep 14, 2026

Copy link
Copy Markdown
Member

内容(8c283f5..1f7e36a,41 个提交)

PG10—PG20 十一个版本的中文文档系统性校准与复审收编:

  • 逐句校准检查点:PG10—20 各版 checkpoint(func/config/libpq 等大文件措辞校准)
  • 跨版本一致性修复:同英文→同中文、相近英文→相近中文原则下的两轮落地
  • 逐版对齐修复:alter_default_privileges/drop_owned/pg_dumpall 对齐 EN、libpq hostaddr 措辞统一
  • 未来内容清除(旧轮):psql 未来元命令/未来 GUC/meson 引用/AIO 缩略语等按版清除
  • EXECUTE-grant 样板句统一:11 版规范化措辞
  • 验收收编:final acceptance round + 遗留关闭 + 生产级四探针全绿(ab4e0bb)+ 并发校准波收编(1f7e36a,含索引词翻译/NULL 措辞归一)
  • 附验收/检查点报告(docs/final-acceptance-*.md 等)

验证

  • 四探针清零(链接完备/id 完备/无重复 id/标题锚定一致);11 版 HTML 独立重建全绿
  • 逐句复审系列账本 49 项全部闭环(详见 outputs/ 评审目录)

Checkpoint the accumulated PG10 Chinese documentation corrections against the pinned PostgreSQL 10.23 English input. Keep this version's text, tables, examples, cross-references and associated localization changes together.

Validation: staged diff check passed; changed XML assets and JSON/Python/Perl sources passed syntax checks where applicable.

This records the current source progress. Independent full-text review and final eleven-version HTML/A4/US PDF acceptance remain pending.
Checkpoint the accumulated PG11 Chinese documentation corrections against the pinned PostgreSQL 11.22 English input. Keep this version's text, tables, examples, cross-references and associated localization changes together.

Validation: staged diff check passed; changed XML assets and JSON/Python/Perl sources passed syntax checks where applicable.

This records the current source progress. Independent full-text review and final eleven-version HTML/A4/US PDF acceptance remain pending.
Checkpoint the accumulated PG12 Chinese documentation corrections against the pinned PostgreSQL 12.22 English input. Keep this version's text, tables, examples, cross-references and associated localization changes together.

Validation: staged diff check passed; changed XML assets and JSON/Python/Perl sources passed syntax checks where applicable.

This records the current source progress. Independent full-text review and final eleven-version HTML/A4/US PDF acceptance remain pending.
Checkpoint the accumulated PG13 Chinese documentation corrections against the pinned PostgreSQL 13.23 English input. Keep this version's text, tables, examples, cross-references and associated localization changes together.

Validation: staged diff check passed; changed XML assets and JSON/Python/Perl sources passed syntax checks where applicable.

This records the current source progress. Independent full-text review and final eleven-version HTML/A4/US PDF acceptance remain pending.
Checkpoint the accumulated PG14 Chinese documentation corrections against the pinned PostgreSQL 14.24 English input. Keep this version's text, tables, examples, cross-references and associated localization changes together.

Validation: staged diff check passed; changed XML assets and JSON/Python/Perl sources passed syntax checks where applicable.

This records the current source progress. Independent full-text review and final eleven-version HTML/A4/US PDF acceptance remain pending.
Checkpoint the accumulated PG15 Chinese documentation corrections against the pinned PostgreSQL 15.19 English input. Keep this version's text, tables, examples, cross-references and associated localization changes together.

Validation: staged diff check passed; changed XML assets and JSON/Python/Perl sources passed syntax checks where applicable.

This records the current source progress. Independent full-text review and final eleven-version HTML/A4/US PDF acceptance remain pending.
Checkpoint the accumulated PG16 Chinese documentation corrections against the pinned PostgreSQL 16.15 English input. Keep this version's text, tables, examples, cross-references and associated localization changes together.

Validation: staged diff check passed; changed XML assets and JSON/Python/Perl sources passed syntax checks where applicable.

This records the current source progress. Independent full-text review and final eleven-version HTML/A4/US PDF acceptance remain pending.
Checkpoint the accumulated PG17 Chinese documentation corrections against the pinned PostgreSQL 17.11 English input. Keep this version's text, tables, examples, cross-references and associated localization changes together.

Validation: staged diff check passed; changed XML assets and JSON/Python/Perl sources passed syntax checks where applicable.

This records the current source progress. Independent full-text review and final eleven-version HTML/A4/US PDF acceptance remain pending.
Checkpoint the accumulated PG18 Chinese documentation corrections against the pinned PostgreSQL 18.6 English input. Keep this version's text, tables, examples, cross-references and associated localization changes together.

Validation: staged diff check passed; changed XML assets and JSON/Python/Perl sources passed syntax checks where applicable.

This records the current source progress. Independent full-text review and final eleven-version HTML/A4/US PDF acceptance remain pending.
Checkpoint the accumulated PG19 Chinese documentation corrections against the pinned PostgreSQL 19beta3 English input. Keep this version's text, tables, examples, cross-references and associated localization changes together.

Validation: staged diff check passed; changed XML assets and JSON/Python/Perl sources passed syntax checks where applicable.

This records the current source progress. Independent full-text review and final eleven-version HTML/A4/US PDF acceptance remain pending.
Checkpoint the accumulated PG20 Chinese documentation corrections against the pinned PostgreSQL 20devel (86f7c82cf1023e3599f40f939727791a7090cd44) English input. Keep this version's text, tables, examples, cross-references and associated localization changes together.

Validation: staged diff check passed; changed XML assets and JSON/Python/Perl sources passed syntax checks where applicable.

This records the current source progress. Independent full-text review and final eleven-version HTML/A4/US PDF acceptance remain pending.
- remove stale pre-PG14 sentence from replication-management intro (zh/14–20, F-035)
- restore SQL literals in timestamp-minus-timestamp example (zh/14–20, F-037)
- restore spaced to_jsonb example output per PG13+ upstream (zh/14–20, F-039)
- add missing "with noted exceptions" clause to signal-functions intro (zh/10–20, F-025⑤)
- translate "temporal tables" link text in release-19 (zh/19)
- verify concurrent calibration fixes (F-030/F-033/F-036/F-038) unified across affected versions

40 precise string replacements this session; same-English-same-Chinese
consistency asserted per fix family across all affected versions.
Per HORIZONTAL-REVIEW.md (F-001..F-034; F-027/F-028/F-012 retracted):
- wording: string constants(10-18), timezone offset(10-20), range >>
  direction(13-20), quarter/WEEK interval clauses(18-20)
- F-034 residual MT fixes in release-18
- F-010 future-content removal: ddl privileges + create_policy MERGE(14),
  pg_aios/pg_shmem_allocations_numa/pg_wait_events sections(15-16),
  createdb --strategy(14)
- F-001 link restoration: snapshot funcs xrefs(16-20), ddl partition links
  (17-18); 0 missing linkend targets across all 11 versions
- build unblock: varlistentry/sect id migration in zh/14/15 per en/16
  canonical ids; zh/10 NET-xref normalization (35 spots)
- all 11 versions build HTML cleanly
… EN; unify libpq hostaddr wording and misc calibration
… EN; unify libpq hostaddr wording and misc calibration
… EN; unify EXECUTE-grant boilerplate and misc calibration
…add plain-text doc section; unify boilerplate
…unique, meson refs); align glossary and information_schema with EN
…nify boilerplate; config index terms and misc calibration
…nify boilerplate; config index terms and misc calibration
The plain-text output sections added in 589668b (zh/14) and d1db99d
(zh/15) lack a sect2 id, which trips the zh stylesheet's missing-id
check and aborts the HTML build for both versions. Use the canonical
id from en/16 (docguide-build-plain-text), matching zh/16. All 11
versions now build HTML cleanly again.
- F-029(16): libpq PG_DIAG_STATEMENT_POSITION typo across all 11
  versions ("而不是以及字节计算" -> "而不是以字节计算")
- F-044 tail: jsonb ?| any-of wording in zh/19-20 func-json
  (completes the 13-20 family; zh/10-12 "任意一个" stays per own EN)
- F-050: restore EN 11-13 false-positive paragraph in amcheck
  "修复损坏" (was a duplicate of the shared-buffer paragraph; the
  correctly-placed copy is kept) in zh/11-13
- zh/14 build self-consistency: drop redundant config-setting-shell
  anchor; renumber misassigned duplicate pg_dump varlistentry id to
  zh18-auto-pg_dump-varlistentry-81

Verified: old-signature sweep zero across zh/; boilerplate family
end states (授予EXECUTE权限 153 / 复制源 589); per-version EN
pairing preserved (F-036/F-042/F-044/F-050 boundaries). All 11
HTML builds pass, zh/14 rebuilt clean (1082 pages, zero warnings).
Series ledger: 49 findings, 46 valid landed, 3 withdrawn; F-001
remainder deferred to incremental translation by design. Acceptance
report: docs/final-acceptance-20260912.md
- Remove dead zh/14/ref/merge.sgml: MERGE is a PG15+ command, en/14.24
  has no such file; the 683-line copy was overshoot from bulk version
  bump 3ca4516. Not in the build graph and zero inbound sql-merge
  references, so deletion is a closed loop; zh/14 HTML rebuilt clean
  (1082 pages, zero warnings).
- F-001 formally closed: quote-agnostic, case-insensitive linkend
  probe over the whole tree shows 0 missing EN reference targets in
  all 11 zh versions (the deferred remainder had already been fixed
  by earlier rounds; the ledger had never re-measured).
- Fix zh/19-20 temporal-isolation.svg font-family: Chinese font name
  '阿里巴巴普惠体 3.0' is unresolvable in the PDF pipeline (Batik),
  dropping 会话/等待/继续/重新 glyphs into Times-Roman and failing
  the strict build; switched to the gin.svg convention
  'Alibaba PuHuiTi 3.0',serif (5 occurrences each).
- Build matrix now complete: 11 HTML + 22 PDF (A4/US) all green;
  artifacts in tmp/pdf/zh/ (gitignored).
- F-001 per-occurrence closure: 19 filexlinkend deficits fixed (%x
  see-transaction-id x5, jsonpath "Similarly" sentences x4,
  pg_logical_slot_get_changes failover clause x4, random/random_normal
  sentence x2, sqljson @@/match parentheticals x6 + wording fix,
  zh/15 SQL/JSON deviations block restored); probe now 0.
- Title consistency (id-anchored, same EN title -> same zh title):
  14 divergences unified (备库/内核资源使用/ACL 权限缩写/配置设置/
  FDW 例程 spacing/并行追加 x9/BufferPin-IO-IPC-LWLock casing restore
  x10/POSIX spacing/— convention x2); probe now 0.
- Anchors: EN-id parity 0 missing (zh/15 AuthenticationSCMCredential
  flow+format entries restored per en/15.19, LSN future-term stub with
  dangling glosssee removed, pg_checksums ids conformed x2, ecpg
  comment-internal ids adjudicated); 0 duplicate ids; builds warning-
  free.
- Untranslated-content sweep: 66 candidates triaged, all legitimate
  (syntax productions, English-usage guide titles, signature cells).
- Punctuation: 374 CJK-adjacent commas/semicolons, 659 colons, 29
  sentence periods normalized to full-width outside code; format
  notations (mm:ss, host:port) and filename dots deliberately kept.
- Incident disclosure: placeholder-masking bug corrupted 9 files;
  restored from HEAD and replayed with a lossless gap-based transform,
  verified by code-block-count and residue probes (0 anomalies).
- Gate: all 11 HTML rebuilds pass at baseline page counts.
- Boundary: 22 files actively co-edited by the concurrent calibration
  session excluded from this commit, left in the working tree.
Reviewed and committed the concurrent session's in-flight calibration
wave (111 files, ~+9k/-11.5k lines) after systematic verification:

- Content alignments spot-checked against EN per version boundary:
  JSON_TABLE future-section removal from zh/14 (en/14 has none),
  applytransaction wait-event removal from zh/15 only (EN 16+),
  %v backendID->procNumber rename in zh/17+, indexterm translations
  (syntax/func families), F-010-style future-content cleanups in
  catalogs/func, dblink/docguide/xfunc prose polish, "shell 类型"
  terminology normalization.
- Completed the wave's partial null-wording normalization in
  zh/15-20 system-views: 257 为空->为 NULL conversions verified
  entry-by-entry against EN (table+field paired, case-insensitive
  null match); format-sensitive phrases (空范围/非空元素) excluded.
- Incident disclosure: my first completion pass had a stale-offset
  splice bug that glued/dropped content in the same six files; fully
  repaired (glue lines removed, truncated entry tags restored,
  missing <row> reinserted, damaged tables rebuilt from HEAD plus
  correct conversion). Verified: tag balance 0 on all six, every
  table's entry count equals EN, no residue patterns tree-wide.
- Gates on the exact committed tree: F-001 per-occurrence 0, EN-id
  parity 0, id-anchored title divergence 0, punctuation probes 0;
  all 11 HTML builds green at baseline page counts with zero
  warnings (zh/10-14 earlier this round, zh/15-20 after repairs).
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant