Skip to content

[fix](doc) zh: backport en-richer examples & fence parity (log10, trim-in, bitmap-hash, to-bitmap, collect-list)#3836

Merged
morningman merged 1 commit into
apache:masterfrom
boluor:fix/misc-en-zh-sync-batchB-misc
May 30, 2026
Merged

[fix](doc) zh: backport en-richer examples & fence parity (log10, trim-in, bitmap-hash, to-bitmap, collect-list)#3836
morningman merged 1 commit into
apache:masterfrom
boluor:fix/misc-en-zh-sync-batchB-misc

Conversation

@boluor
Copy link
Copy Markdown
Contributor

@boluor boluor commented May 28, 2026

Summary

Five small zh-side patches surfaced by the verifier, all bringing ZH up to parity with EN:

  • log10.md (zh): add the NULL and NaN examples (corner cases the EN page explicitly documents)
  • trim-in.md (zh): backport example 3 (与 TRIM 函数对比). ZH's numbering even jumped 2 → 4, so this was a known omission
  • bitmap-hash.md (zh): the first example's opening fence was a plain ```, re-flagged as ```sql so the verifier identifies it as runnable
  • to-bitmap.md (zh): the syntax was an inline single-backtick code span; switched to a ```sql fenced block matching EN. Also translated one stray English caption ("The result will be:") that had been left untranslated
  • collect-list.md (zh): syntax was ```text instead of ```sql; aligned with EN

All inserted examples were verified against Doris 4.1.1 outputs.

🤖 Generated with Claude Code

…10, trim-in, bitmap-hash, to-bitmap, collect-list)

log10.md zh: add the NULL and NaN examples that exist on EN (these are
  the corner cases the EN page explicitly documents).

trim-in.md zh: backport example 3 ("与 TRIM 函数对比") -- ZH numbering
  even jumped 2 -> 4, so this was a known omission.

bitmap-hash.md zh: the first example's opening fence was a plain ``` ;
  re-flag as ```sql so the verifier identifies it as a runnable example.

to-bitmap.md zh: the syntax was an inline single-backtick code span;
  switched to a ```sql fenced block matching EN. Also fixed an English
  caption ("The result will be:") that was left untranslated.

collect-list.md zh: syntax was wrapped in ```text instead of ```sql;
  aligned with EN.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@morningman morningman merged commit 603b131 into apache:master May 30, 2026
3 checks passed
morningman pushed a commit that referenced this pull request May 30, 2026
…EN DESC-TABLE example expansion (#3847)

## Summary

Mechanical port of the 4.x fixes in #3830, #3831, #3832, #3834, #3835,
#3836 to dev/master. Every change here was verified to still be needed
on today's master build (cluster deployed from selectdb-qa-test tarball,
5.14 GB).

Three 4.x fixes turned out to be already-applied on dev and are **not**
included in this PR (skipping):
- log10 ZH (NULL/NaN examples already in dev)
- strleft ZH (example 9 already removed in dev)
- milliseconds-add EN (BIGINT-range example already in dev)

## Files (15)

### ZH (`i18n/zh-CN/.../current/`)
- **arrays-overlap.md** — remove two stray `'` after closing fences
- **unix-timestamp.md** — add missing semicolon after `select
unix_timestamp('1007-11-30 10:30:19')`
- **DESC-TABLE.md** — drop `demo.` qualifier (`DESC demo.test_table ALL`
→ `DESC test_table ALL`); fix stale `DUP_KEYS` cell → `UNIQUE_KEYS`
(matches the page's own `UNIQUE KEY(user_id)` setup)
- **week.md** — drop the ` ```sql ` wrapper around the Mode definition
markdown table
- **milliseconds-add.md** — remove 5 copy-paste duplicate examples; fix
BIGINT-range example expected output (\"returns NULL\" → actual
`2023-10-03 12:33:32.083000`)
- **9 array / bitmap / aggregate / string files** — fence-flavor parity
(` ``` ` or ` ```text ` → ` ```sql ` where the block contains runnable
SQL). `trim-in.md` additionally adds example 3 (TRIM comparison) that
was missing.

### EN (`docs/`)
- **DESC-TABLE.md** — add a CREATE TABLE setup block, backport the two
ZH-only examples (Comment column via `show_column_comment_in_describe`,
and `DESC ... ALL`). The Comment-column behavior was already mentioned
in the Return-Value section but never exemplified.

## Verification

Verified end-to-end against today's master cluster — every added example
runs cleanly, behaviors documented are the same on master as on 4.1.1
(no master-side regression on
log10/MINUTE/SPLIT_PART/UNHEX/count_by_enum either).

## Related 4.x PRs
#3830 #3831 #3832 #3834 #3835 #3836

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
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.

2 participants