Skip to content

[GH-2867] Translate Stats, Viz, and SQL overview pages to Chinese#2947

Merged
jiayuasu merged 1 commit into
apache:masterfrom
jiayuasu:feature/zh-stats-viz-sql-overview
May 11, 2026
Merged

[GH-2867] Translate Stats, Viz, and SQL overview pages to Chinese#2947
jiayuasu merged 1 commit into
apache:masterfrom
jiayuasu:feature/zh-stats-viz-sql-overview

Conversation

@jiayuasu
Copy link
Copy Markdown
Member

Did you read the Contributor Guide?

Is this PR related to a ticket?

Bundles three sub-phases (small enough to review together): closes #2913, closes #2914, closes #2916.

What changes were proposed in this PR?

Adds Simplified Chinese (*.zh.md) translations for the docs site, covering the Stats/Viz API entry pages and the SQL API overview/concept pages:

Phase 6 (#2913) — Stats & Viz reference (3 files):

  • docs/api/stats/sql.md
  • docs/api/viz/sql.md
  • docs/api/viz/java-api.md

Phase 7 (#2914) — SQL API overview & concepts (10 files):

  • Overview.md, Optimizer.md, NearestNeighbourSearching.md, CRS-Transformation.md, Parameter.md, DataFrameAPI.md, Visualization-SedonaPyDeck.md, Visualization-SedonaKepler.md, Reading-legacy-parquet.md, Spider.md

Phase 9 (#2916) — SQL Raster concept pages (2 files):

  • Raster-map-algebra.md, Raster-affine-transformation.md

15 new files; no existing files modified; no nav changes (the labels were translated centrally in mkdocs.yml in earlier phases).

Intentionally left in English

The pure function reference pages — docs/api/sql/Geometry-Functions.md, docs/api/sql/Raster-Functions.md, and the per-function detail files under docs/api/sql/Geometry-*/, docs/api/sql/Raster-*/, docs/api/flink/, docs/api/snowflake/ — are intentionally left in English. They are dominated by function signatures, parameter tables, return types, and code blocks, where the English source is the canonical spec; translating the surrounding prose adds little value vs. the maintenance overhead. Follow-up sub-issues #2915 / #2917 / #2918 will be closed with this rationale.

How was this patch tested?

  • Mechanical checks: every .zh.md has the ASF license header at the top (pre-commit insert-license hook passes); all markdown links, code blocks, function names, and table cells containing code/identifiers are preserved verbatim from the English source.
  • Style consistency with prior phases verified against docs/setup/overview.zh.md, docs/tutorial/sql.zh.md, docs/community/develop.zh.md.

Did this PR include necessary documentation updates?

  • No, this PR does not affect any public API so no need to change the documentation.

Bundles three sub-phases of the docs i18n EPIC:

- Phase 6 (apache#2913) — Stats & Viz API reference: docs/api/stats/sql,
  docs/api/viz/sql, docs/api/viz/java-api
- Phase 7 (apache#2914) — SQL API overview & concepts: Overview, Optimizer,
  NearestNeighbourSearching, CRS-Transformation, Parameter,
  DataFrameAPI, Visualization-SedonaPyDeck, Visualization-SedonaKepler,
  Reading-legacy-parquet, Spider
- Phase 9 (apache#2916) — SQL Raster concept pages: Raster-map-algebra,
  Raster-affine-transformation

The pure function reference pages (Geometry-Functions.md,
Raster-Functions.md, and per-function detail files under api/sql/) are
intentionally left in English: they are dominated by function signatures,
parameter tables, and code, where the English source is the canonical
spec and translation churn outweighs the readability benefit.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

1 participant