Ramin Gharib created FLINK-41590:
------------------------------------

             Summary: Translate the pages of the comparison, boolean, hash, 
JSON and VARIANT functions into Chinese
                 Key: FLINK-41590
                 URL: https://issues.apache.org/jira/browse/FLINK-41590
             Project: Flink
          Issue Type: Sub-task
          Components: chinese-translation, Documentation
            Reporter: Ramin Gharib


FLINK-41568 moves the comparison, boolean, hash, JSON and VARIANT functions to 
pages of their own, generated from 
{{docs/data/functions/<category>/<name>.yml}}. The Chinese pages show the 
English sections. Where a converted row in {{docs/data/sql_functions_zh.yml}} 
had a Chinese description, only its first sentence was kept, as the summary in 
{{docs/data/functions_zh/<category>/<name>.yml}}. The rest is no longer shown: 
about 1,600 Chinese characters across 49 rows.

h3. Scope
* The 40 pages under {{docs/data/functions/}} in the categories {{comparison}}, 
{{boolean}}, {{hash}}, {{json}} and {{variant}}.
* 25 of them have a Chinese summary, and 15 have no Chinese text at all.
* The pages "XML and VARIANT" and "VARIANT Paths" under 
{{docs/content.zh/docs/sql/built-in-functions/variant/}} are in English too.

h3. How to translate
* Put the translation in {{docs/data/functions_zh/<category>/<name>.yml}}. Each 
field it sets, such as {{notes}} or {{returns}}, replaces the English one. The 
fields it doesn't set fall back to English.
* The Chinese descriptions of these rows before FLINK-41568 are in 
{{docs/data/sql_functions_zh.yml}} at commit 
{{321f3eb5b44782e191ffe42e30e76334159ce57f}}. They can be reused where they 
still match the English page.
* {{docs/README.md}}, section "Built-in function pages", describes the fields.

The translation needs a native speaker. Until then, the English text is the 
placeholder. FLINK-41529 covers the categories of FLINK-41433 the same way.



--
This message was sent by Atlassian Jira
(v10.3.26#10030026)

Reply via email to