You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@sedona.apache.org by "jiayuasu (via GitHub)" <gi...@apache.org> on 2026/05/08 06:51:02 UTC

[PR] [GH-2911] Translate Tutorial / Programming Guide (part 2) to Chinese [sedona]

jiayuasu opened a new pull request, #2933:
URL: https://github.com/apache/sedona/pull/2933

   ## Did you read the Contributor Guide?
   
   - Yes, I have read the [Contributor Rules](https://sedona.apache.org/latest/community/rule/) and [Contributor Development Guide](https://sedona.apache.org/latest/community/develop/)
   
   ## Is this PR related to a ticket?
   
   - Yes, and the PR name follows the format `[GH-XXX] my subject`. Part of #2911 (Phase 4 of EPIC #2867). Follows up on Phase 4a (#2931). The 4 largest tutorial pages will land in Phase 4c.
   
   ## What changes were proposed in this PR?
   
   Phase 4b of the Chinese-documentation EPIC (#2867). Adds Chinese (`zh`) translations for 6 more tutorial pages on top of the 17 merged in #2931.
   
   **Translated in this PR (6 files, ~2,500 lines of source content):**
   
   - `files/`: `geoparquet-sedona-spark`, `stac-sedona-spark`
   - `geopandas-shapely`, `geopandas-api`
   - `concepts/`: `spatial-joins`
   - `flink/`: `sql`
   
   **Deferred to Phase 4c (4 large files, ~3,690 lines combined):** `tutorial/sql.md` (1,438 lines), `tutorial/rdd.md` (871), `tutorial/raster.md` (764), `tutorial/snowflake/sql.md` (618). These individually warrant their own focused review pass.
   
   After this PR, **23 of 27** tutorial pages have Chinese versions on the docs site.
   
   Code blocks, command snippets, version macros (`{{ sedona.current_version }}`, `{{ sedona.current_geotools }}`), admonitions, and inline tab attributes (`=== "Scala"`, etc.) are preserved verbatim. Only prose, headings, table headers, and explanatory inline comments are translated.
   
   ## How was this patch tested?
   
   Built the docs locally with `uv sync --group docs && uv run mkdocs build` and verified:
   
   - The build succeeds with no new warnings introduced by Phase 4b.
   - 6 new `*.zh.md` files render under `/zh/tutorial/`, `/zh/tutorial/concepts/`, `/zh/tutorial/files/`, `/zh/tutorial/flink/`.
   - The 4 untranslated pages still fall back to English content via `fallback_to_default: true`.
   - `pre-commit run --all-files` passes including `blacken-docs` (which auto-added the ASF license headers — re-staged before commit).
   
   ## Did this PR include necessary documentation updates?
   
   - Yes, this PR is itself a documentation translation. Phase 4c will translate the remaining 4 tutorial pages.


-- 
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: issues-unsubscribe@sedona.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


Re: [PR] [GH-2911] Translate Tutorial / Programming Guide (part 2) to Chinese [sedona]

Posted by "jiayuasu (via GitHub)" <gi...@apache.org>.
jiayuasu merged PR #2933:
URL: https://github.com/apache/sedona/pull/2933


-- 
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: issues-unsubscribe@sedona.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org