Conversation
WalkthroughAdds a CodeRabbit config, introduces an AsciiDoc review GitHub Actions workflow, removes the PR preview workflow, and adds/edits multiple documentation pages (Chinese NLS reference and small EN/CN textual adjustments). No changes to exported/public program interfaces. Changes
Sequence Diagram(s)sequenceDiagram
autonumber
actor Developer as Dev
participant GitHub as GH
participant Actions as "GitHub Actions: AsciiDoc Review"
participant Ruby as "Ruby / Asciidoctor"
participant Node as "Node / asciidoc-link-check"
Dev->>GH: Push or open PR with .adoc/.asciidoc changes
GH->>Actions: Trigger workflow
Actions->>Ruby: Setup Ruby 3.2 & Bundler cache
Ruby->>Ruby: Install Asciidoctor + diagram support
Actions->>Ruby: Validate AsciiDoc (strict)
alt No AsciiDoc files found
Actions-->>GH: Skip validation & link checks
else AsciiDoc files present
Actions->>Node: Setup Node.js 18
Node->>Node: Install asciidoc-link-check
Actions->>Node: Create .asciidoc-link-check.json
Node->>Node: Run internal link checks via npx
end
Actions-->>GH: Report workflow result (success/failure)
Estimated code review effort🎯 3 (Moderate) | ⏱️ ~25 minutes Poem
Pre-merge checks and finishing touches❌ Failed checks (1 inconclusive)
✅ Passed checks (2 passed)
✨ Finishing touches🧪 Generate unit tests (beta)
Comment |
![coderabbitai[bot]](https://avatars.githubusercontent.com/in/347564?s=60&v=4){kind=small}
There was a problem hiding this comment.
Actionable comments posted: 2
📜 Review details
Configuration used: Path: .coderabbit.yaml
Review profile: CHILL
Plan: Pro
📒 Files selected for processing (3)
.coderabbit.yaml(1 hunks).github/workflows/adoc-review.yml(1 hunks)CN/modules/ROOT/pages/master/6.3.5.adoc(1 hunks)
🧰 Additional context used
🪛 actionlint (1.7.8)
.github/workflows/adoc-review.yml
24-24: the runner of "actions/cache@v3" action is too old to run on GitHub Actions. update the action's version to fix this issue
(action)
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (1)
- GitHub Check: adoc-review
| - name: Cache gems | ||
| uses: actions/cache@v3 | ||
| with: | ||
| path: ~/.gem | ||
| key: ${{ runner.os }}-gems-${{ hashFiles('**/Gemfile.lock') }} | ||
| restore-keys: | | ||
| ${{ runner.os }}-gems- |
There was a problem hiding this comment.
Update to actions/cache@v4
actions/cache@v3 no longer runs on the current GitHub-hosted runners, so this workflow will fail before any validation happens. Please bump the action to actions/cache@v4. (Based on static analysis hints)
Apply this diff:
- - name: Cache gems
- uses: actions/cache@v3
+ - name: Cache gems
+ uses: actions/cache@v4📝 Committable suggestion
‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.
| - name: Cache gems | |
| uses: actions/cache@v3 | |
| with: | |
| path: ~/.gem | |
| key: ${{ runner.os }}-gems-${{ hashFiles('**/Gemfile.lock') }} | |
| restore-keys: | | |
| ${{ runner.os }}-gems- | |
| - name: Cache gems | |
| uses: actions/cache@v4 | |
| with: | |
| path: ~/.gem | |
| key: ${{ runner.os }}-gems-${{ hashFiles('**/Gemfile.lock') }} | |
| restore-keys: | | |
| ${{ runner.os }}-gems- |
🧰 Tools
🪛 actionlint (1.7.8)
24-24: the runner of "actions/cache@v3" action is too old to run on GitHub Actions. update the action's version to fix this issue
(action)
🤖 Prompt for AI Agents
.github/workflows/adoc-review.yml around lines 23 to 29: the workflow uses
actions/cache@v3 which is unavailable on current GitHub-hosted runners; update
the action reference to actions/cache@v4 by replacing uses: actions/cache@v3
with uses: actions/cache@v4 so the cache step runs successfully on modern
runners.
| - name: Validate AsciiDoc syntax | ||
| run: | | ||
| set -e | ||
| files=$(find . -name "*.adoc" -o -name "*.asciidoc") | ||
| if [ -n "$files" ]; then | ||
| echo "Found AsciiDoc files to validate:" | ||
| echo "$files" | ||
| echo "$files" | xargs -I {} sh -c 'echo "Validating: $1" && asciidoctor -b docbook -o /dev/null "$1"' _ {} | ||
| else | ||
| echo "No AsciiDoc files found to validate" | ||
| fi | ||
|
|
||
| - name: Setup Node.js | ||
| uses: actions/setup-node@v4 | ||
| with: | ||
| node-version: '18' | ||
|
|
||
| - name: Install asciidoc-link-check | ||
| run: npm install --save-dev asciidoc-link-check | ||
|
|
||
| - name: Create link check config | ||
| run: | | ||
| cat > .asciidoc-link-check.json << 'EOF' | ||
| { | ||
| "ignorePatterns": [ | ||
| { | ||
| "pattern": "^http://localhost" | ||
| } | ||
| ], | ||
| "timeout": "10s", | ||
| "retryOn429": true, | ||
| "retryCount": 3 | ||
| } | ||
| EOF | ||
|
|
||
| - name: Check internal links | ||
| run: | | ||
| find . \( -name "*.adoc" -o -name "*.asciidoc" \) | xargs -I {} npx asciidoc-link-check -c .asciidoc-link-check.json {} No newline at end of file |
There was a problem hiding this comment.
Handle filenames safely when piping from find
Saving the file list in a scalar and piping through plain xargs breaks for paths containing whitespace or newlines, so those files will be skipped or cause false failures. Switch to the -print0/xargs -0 pattern (and reuse it in the link-check step) so every AsciiDoc file is processed reliably.
Apply this diff:
- files=$(find . -name "*.adoc" -o -name "*.asciidoc")
- if [ -n "$files" ]; then
- echo "Found AsciiDoc files to validate:"
- echo "$files"
- echo "$files" | xargs -I {} sh -c 'echo "Validating: $1" && asciidoctor -b docbook -o /dev/null "$1"' _ {}
+ mapfile -d '' files < <(find . -type f \( -name "*.adoc" -o -name "*.asciidoc" \) -print0)
+ if [ "${#files[@]}" -gt 0 ]; then
+ echo "Found AsciiDoc files to validate:"
+ printf '%s\n' "${files[@]}"
+ printf '%s\0' "${files[@]}" | xargs -0 -I {} sh -c 'echo "Validating: $1" && asciidoctor -b docbook -o /dev/null "$1"' _ {}- find . \( -name "*.adoc" -o -name "*.asciidoc" \) | xargs -I {} npx asciidoc-link-check -c .asciidoc-link-check.json {}
+ find . -type f \( -name "*.adoc" -o -name "*.asciidoc" \) -print0 | xargs -0 -I {} npx asciidoc-link-check -c .asciidoc-link-check.json {}🤖 Prompt for AI Agents
.github/workflows/adoc-review.yml around lines 36-73: the current steps collect
filenames into a shell scalar and pass them through plain xargs which breaks on
filenames with spaces/newlines; update both the AsciiDoc validation step and the
link-check step to use find ... -print0 and xargs -0 (or equivalent while-read
-d '' loops) so file paths are passed safely; specifically replace the scalar
assignment and echo/xargs pipeline with a null-delimited pipeline (find . -name
"*.adoc" -o -name "*.asciidoc" -print0 | xargs -0 ...) and similarly change the
final link-check find invocation to use -print0 piped to xargs -0 to ensure
every file is processed correctly.
There was a problem hiding this comment.
Actionable comments posted: 2
♻️ Duplicate comments (3)
.github/workflows/adoc-review.yml (3)
23-29: 升级到 actions/cache@v4（或移除该步骤）
该问题已在先前评论中提出：v3 已无法在当前托管运行器上执行，应使用 v4。最小修复：
- - name: Cache gems - uses: actions/cache@v3 + - name: Cache gems + uses: actions/cache@v4
36-46: 安全处理文件名并增强校验：使用 -print0/-0、加载 diagram、强化 shell 选项
该建议包含对先前“find/xargs 的 -print0/-0”问题的重复提醒与额外改进。
- 使用 find -print0 与 xargs -0，避免空格/换行导致文件遗漏或误判。
- 限定 -type f，括号分组条件。
- 加载 asciidoctor-diagram（已安装，否则 diagram 块不会被处理）。
- 可改为 html5 后端更通用（避免 docbook 转换器依赖）。
- 强化 shell：set -Eeuo pipefail。
示例修改：
- - name: Validate AsciiDoc syntax - run: | - set -e - files=$(find . -name "*.adoc" -o -name "*.asciidoc") - if [ -n "$files" ]; then - echo "Found AsciiDoc files to validate:" - echo "$files" - echo "$files" | xargs -I {} sh -c 'echo "Validating: $1" && asciidoctor -b docbook -o /dev/null "$1"' _ {} - else - echo "No AsciiDoc files found to validate" - fi + - name: Validate AsciiDoc syntax + run: | + set -Eeuo pipefail + mapfile -d '' files < <(find . -type f \( -name "*.adoc" -o -name "*.asciidoc" \) -print0) + if [ "${#files[@]}" -gt 0 ]; then + echo "Found AsciiDoc files to validate:" + printf '%s\n' "${files[@]}" + printf '%s\0' "${files[@]}" | xargs -0 -I {} sh -c \ + 'echo "Validating: $1" && asciidoctor -r asciidoctor-diagram -b html5 -o /dev/null "$1"' _ {} + else + echo "No AsciiDoc files found to validate" + fi
71-73: 链接检查同样使用 -print0/-0 和 -type f，避免路径问题
与先前评论一致，使用空字符分隔可避免路径中空格/换行的隐患。- find . \( -name "*.adoc" -o -name "*.asciidoc" \) | xargs -I {} npx asciidoc-link-check -c .asciidoc-link-check.json {} + find . -type f \( -name "*.adoc" -o -name "*.asciidoc" \) -print0 | xargs -0 -I {} npx asciidoc-link-check -c .asciidoc-link-check.json {}
🧹 Nitpick comments (6)
.github/workflows/adoc-review.yml (2)
17-35: 统一 Ruby 依赖管理方式，避免“bundler-cache + gem install”的混用当前同时启用了 bundler-cache 且用 gem install 手工安装依赖，缓存并不会发挥作用，且不可复现。建议二选一：
方案 A（推荐，可复现）：
- 在仓库添加 Gemfile，锁定版本：
- gem 'asciidoctor', '~> 2.0'
- gem 'asciidoctor-diagram', '~> 2.2'
- 使用 bundler 缓存，移除单独的 cache gems 步骤与 gem install：
- name: Setup Ruby uses: ruby/setup-ruby@v1 with: ruby-version: '3.2' bundler-cache: true - - - name: Cache gems - uses: actions/cache@v3 - with: - path: ~/.gem - key: ${{ runner.os }}-gems-${{ hashFiles('**/Gemfile.lock') }} - restore-keys: | - ${{ runner.os }}-gems- - - - name: Install Asciidoctor - run: | - gem install asciidoctor --version '~> 2.0' - gem install asciidoctor-diagram --version '~> 2.2' + # 安装将由 ruby/setup-ruby@v1 的 bundler-cache 自动完成方案 B（轻量，非 bundler）：
- 保留 gem install，但关闭 bundler-cache，并精简为无文档安装以加快速度：
- name: Setup Ruby uses: ruby/setup-ruby@v1 with: ruby-version: '3.2' - bundler-cache: true + bundler-cache: false - - name: Cache gems - uses: actions/cache@v4 - ... - - name: Install Asciidoctor - run: | - gem install asciidoctor --version '~> 2.0' - gem install asciidoctor-diagram --version '~> 2.2' + - name: Install Asciidoctor + run: | + gem install --no-document asciidoctor --version '~> 2.0' + gem install --no-document asciidoctor-diagram --version '~> 2.2'若需要验证 diagram（如 Graphviz），请确保安装系统依赖（例如 graphviz）。
11-14: 可选：为工作流添加并发控制，避免冗余运行在频繁推送场景下，取消过时作业能节省资源、提高反馈速度。
jobs: adoc-review: runs-on: ubuntu-latest + concurrency: + group: adoc-review-${{ github.ref }} + cancel-in-progress: trueCN/modules/ROOT/pages/master/6.3.5.adoc (4)
46-49: 将 Markdown 风格的代码块改为 AsciiDoc 原生代码块AsciiDoc 推荐使用 ---- 作为代码块分隔。当前 ``` 可能无法被正确解析。
-``` - DO [ LANGUAGE lang_name ] code [USING IN | OUT | IN OUT, ...] -``` +---- +DO [ LANGUAGE lang_name ] code [USING IN | OUT | IN OUT, ...] +----
68-76: 代码示例使用 AsciiDoc 列表块或标注语言的源码块将 ``` 包围的片段替换为 AsciiDoc 语法，并可选标注 SQL 以利高亮/渲染。
- ``` - ivorysql=# select * from get_parameter_description('insert into t values(:x, :y);'); - name | position - -------+---------- - false | 0 - :x | 1 - :y | 2 - (3 rows) - ``` + [source,sql] + ---- + ivorysql=# select * from get_parameter_description('insert into t values(:x, :y);'); + name | position + -------+---------- + false | 0 + :x | 1 + :y | 2 + (3 rows) + ----
6-7: 可选：标题无需加粗标记文档标题直接使用“=”更简洁一致；去掉标题内的加粗标记。
-= **功能概述** += 功能概述
27-41: 可选：统一术语大小写与命名风格文内 “pliSQL/PLiSQL/PL/iSQL” 出现多种写法。建议在全文统一为项目约定的术语（例如“PL/iSQL”），以提升一致性。
📜 Review details
Configuration used: Path: .coderabbit.yaml
Review profile: CHILL
Plan: Pro
📒 Files selected for processing (3)
.coderabbit.yaml(1 hunks).github/workflows/adoc-review.yml(1 hunks)CN/modules/ROOT/pages/master/6.3.5.adoc(1 hunks)
🚧 Files skipped from review as they are similar to previous changes (1)
- .coderabbit.yaml
🧰 Additional context used
🪛 actionlint (1.7.8)
.github/workflows/adoc-review.yml
24-24: the runner of "actions/cache@v3" action is too old to run on GitHub Actions. update the action's version to fix this issue
(action)
| branches: [main, master] | ||
| paths: ['**.adoc', '**.asciidoc'] | ||
| pull_request: | ||
| branches: [main, master] | ||
| paths: ['**.adoc', '**.asciidoc'] |
There was a problem hiding this comment.
修正触发路径模式，确保在子目录下的文档变更能触发工作流
当前使用的通配符为 '.adoc' 与 '.asciidoc'，这通常不会匹配子目录内的文件。应改为 '/*.adoc' 与 '/*.asciidoc'。
建议修改：
- paths: ['**.adoc', '**.asciidoc']
+ paths: ['**/*.adoc', '**/*.asciidoc']
@@
- paths: ['**.adoc', '**.asciidoc']
+ paths: ['**/*.adoc', '**/*.asciidoc']📝 Committable suggestion
‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.
| branches: [main, master] | |
| paths: ['**.adoc', '**.asciidoc'] | |
| pull_request: | |
| branches: [main, master] | |
| paths: ['**.adoc', '**.asciidoc'] | |
| branches: [main, master] | |
| paths: ['**/*.adoc', '**/*.asciidoc'] | |
| pull_request: | |
| branches: [main, master] | |
| paths: ['**/*.adoc', '**/*.asciidoc'] |
🤖 Prompt for AI Agents
.github/workflows/adoc-review.yml around lines 5 to 9: the current path patterns
'**.adoc' and '**.asciidoc' won't match files in subdirectories; update both
occurrences (under push and pull_request) to use glob patterns with a slash like
'**/*.adoc' and '**/*.asciidoc' so changes to docs in subfolders trigger the
workflow.
There was a problem hiding this comment.
Actionable comments posted: 1
♻️ Duplicate comments (1)
CN/modules/ROOT/pages/master/6.3.5.adoc (1)
83-88: 补全句子以保持语义完整Line 87“这些函数与OCI接口相应函数类似， 在说什么。”仍是不完整句子，请按建议补全文意。
-3. libpq接口端：提供准备、绑定、执行函数， 这些函数与OCI接口相应函数类似， 在说什么。 +3. libpq接口端：提供准备、绑定、执行函数，这些函数在接口设计与用途上与 OCI 对应函数相似，用于准备语句、绑定参数并执行查询。
📜 Review details
Configuration used: Path: .coderabbit.yaml
Review profile: CHILL
Plan: Pro
📒 Files selected for processing (3)
.coderabbit.yaml(1 hunks)CN/modules/ROOT/pages/master/6.3.5.adoc(1 hunks)EN/modules/ROOT/pages/master/welcome.adoc(1 hunks)
🚧 Files skipped from review as they are similar to previous changes (1)
- .coderabbit.yaml
There was a problem hiding this comment.
Actionable comments posted: 1
📜 Review details
Configuration used: Path: .coderabbit.yaml
Review profile: CHILL
Plan: Pro
📒 Files selected for processing (4)
.coderabbit.yaml(1 hunks).github/workflows/pr-preview.yml(0 hunks)CN/modules/ROOT/pages/master/6.3.5.adoc(1 hunks)EN/modules/ROOT/pages/master/welcome.adoc(1 hunks)
💤 Files with no reviewable changes (1)
- .github/workflows/pr-preview.yml
🚧 Files skipped from review as they are similar to previous changes (1)
- EN/modules/ROOT/pages/master/welcome.adoc
| [NOTE] | ||
| ==== | ||
| `to_number()`函数尚未实现。傻大姐撒低级啊实打实 | ||
| ==== No newline at end of file |
There was a problem hiding this comment.
Clean up the NOTE block text
The sentence “傻大姐撒低级啊实打实” is meaningless and makes the documentation look unprofessional. Please delete the gibberish or replace it with a meaningful description of the current limitation.
Apply this diff to fix the NOTE block:
[NOTE]
====
-`to_number()`函数尚未实现。傻大姐撒低级啊实打实
+`to_number()`函数尚未实现。
====📝 Committable suggestion
‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.
| [NOTE] | |
| ==== | |
| `to_number()`函数尚未实现。傻大姐撒低级啊实打实 | |
| ==== | |
| [NOTE] | |
| ==== | |
| `to_number()`函数尚未实现。 | |
| ==== |
🤖 Prompt for AI Agents
In CN/modules/ROOT/pages/master/6.3.5.adoc between lines 136 to 139, the NOTE
block contains an unprofessional and meaningless sentence. Remove the phrase
“傻大姐撒低级啊实打实” completely or replace it with a clear, professional explanation
about the function `to_number()` not yet being implemented.
There was a problem hiding this comment.
Actionable comments posted: 2
📜 Review details
Configuration used: Path: .coderabbit.yaml
Review profile: CHILL
Plan: Pro
📒 Files selected for processing (2)
CN/modules/ROOT/pages/master/6.3.5.adoc(1 hunks)EN/modules/ROOT/pages/master/welcome.adoc(1 hunks)
✅ Files skipped from review due to trivial changes (1)
- CN/modules/ROOT/pages/master/6.3.5.adoc
| IvorySQL project is an open source project proposed by Highgo Software to add the Oracle compatibility features into the popular PostgreSQL database. | ||
|
|
||
| It is Apache licensed Open Source and always free to use. Any comments please contact support@ivorysql.org | ||
| It was Apache licensed Open Source and always free to used. Any comments please contact support@ivorysql.org |
There was a problem hiding this comment.
Revert to accurate licensing statement.
Switching to past tense and “free to used” makes the sentence both grammatically wrong and factually misleading—IvorySQL remains Apache-licensed and free to use. Please restore the original wording.
🤖 Prompt for AI Agents
In EN/modules/ROOT/pages/master/welcome.adoc around line 15, revert the modified
sentence to present tense and correct grammar: replace "It was Apache licensed
Open Source and always free to used. Any comments please contact
support@ivorysql.org" with a clear present-tense, grammatically correct sentence
such as "It is Apache-licensed Open Source and free to use. Any comments please
contact support@ivorysql.org" (ensure "Apache-licensed" hyphenation and "use"
instead of "used").
| https://docs.ivorysql.org/en/ivorysql-doc/v4.5/ivorysql.pdf[IvorySQL v4.5 pdf documentation] | ||
|
|
||
|
|
||
| 是的 No newline at end of file |
There was a problem hiding this comment.
Remove unintended placeholder text.
The standalone “是的” looks like accidental placeholder/debug text and disrupts the English welcome page. Please delete it.
🤖 Prompt for AI Agents
In EN/modules/ROOT/pages/master/welcome.adoc around line 21, remove the
unintended placeholder text "是的" so the English welcome page contains only the
intended content; ensure no other accidental non-English fragments remain on
that line and save the file.
| ==== | ||
|
|
||
|
|
||
| 还是大师啊时代是 No newline at end of file |
There was a problem hiding this comment.
删除文末的无意义文字。
“还是大师啊时代是”毫无语义且显得不专业，请删除或改成有意义的总结语句。
🤖 Prompt for AI Agents
在 CN/modules/ROOT/pages/master/6.3.5.adoc
第142行，行尾存在无意义文字“还是大师啊时代是”；请删除该短语或将其替换为一条有意义、专业的总结性语句（例如一句简短的归纳或过渡句），确保语句通顺且与前后内容衔接一致。
There was a problem hiding this comment.
Actionable comments posted: 1
🧹 Nitpick comments (1)
CN/modules/ROOT/pages/master/6.4.adoc (1)
69-69: 句末标点建议。此处是完整陈述句，建议以句号结束而非分号，保持全文标点一致。
📜 Review details
Configuration used: Path: .coderabbit.yaml
Review profile: CHILL
Plan: Pro
📒 Files selected for processing (2)
CN/modules/ROOT/pages/master/6.4.adoc(2 hunks)EN/modules/ROOT/pages/master/6.4.adoc(1 hunks)
✅ Files skipped from review due to trivial changes (1)
- EN/modules/ROOT/pages/master/6.4.adoc
| 设置一个全局变量is_load_gb18030_2022,默认为true,当用户指定-E选项时,在get_encoding_id中判断其设置的是否为gb18030_2022,如果是, 将其字符串转为gb18030,然后将is_load_gb18030_2022 设为true,如果-E 选项为Gb18030,将其设为false。 | ||
|
|
||
| 在适当位置判断是否要加载插件,如果是,执行load_gb18030_2022,并将ivorysql.conf中的shared_preload_library添加gb18030_2022。 | ||
| 在适当位置判断是否要加载插件, 如果是,执行load_gb18030_2022,并将ivorysql.conf中的shared_preload_library添加gb18030_2022。 |
There was a problem hiding this comment.
Fix the GUC name.
应为 shared_preload_libraries（复数形式）。当前写法会误导用户配置错误的参数名。
🤖 Prompt for AI Agents
In CN/modules/ROOT/pages/master/6.4.adoc around line 30, the document uses the
incorrect GUC name "shared_preload_library"; change the text to the correct
plural form "shared_preload_libraries" so readers configure the correct
parameter (e.g., instruct to add gb18030_2022 to shared_preload_libraries in
ivorysql.conf).
There was a problem hiding this comment.
@coderabbitai why EN/modules/ROOT/pages/master/6.4.adoc was skipped from review, please review it again.
There was a problem hiding this comment.
🧩 Analysis chain
🏁 Script executed:
#!/bin/bash
# Fetch the diff for the English version of the file
git diff origin/master HEAD -- EN/modules/ROOT/pages/master/6.4.adoc
Length of output: 35
🏁 Script executed:
#!/bin/bash
# Check current branch and get the diff for the English file
echo "=== Current branch ==="
git branch -a
echo -e "\n=== Diff for EN/modules/ROOT/pages/master/6.4.adoc ==="
# Try to get diff from the merge base
git diff master...HEAD -- EN/modules/ROOT/pages/master/6.4.adoc
# If that doesn't work, try showing the file changes in the current branch
if [ $? -ne 0 ]; then
echo -e "\n=== Alternative: Show changes in current commit ==="
git log --oneline --all -- EN/modules/ROOT/pages/master/6.4.adoc | head -5
git diff HEAD~1 HEAD -- EN/modules/ROOT/pages/master/6.4.adoc
fi
Length of output: 1718
@OreoYang, I've reviewed the English file. The change in EN/modules/ROOT/pages/master/6.4.adoc is minimal but introduces a grammatical issue.
Review of EN/modules/ROOT/pages/master/6.4.adoc
Issue: Grammatically awkward phrasing
Line 29 now reads:
...and the gb18030_2022 extension is added to the shared_preload_libraries parameter in ivorysql.conf files.
The phrase "ivorysql.conf files" is grammatically awkward and unclear. Consider one of these alternatives:
- Option 1 (Recommended): "...in the
ivorysql.conffile" (singular, with article) - Option 2: "...in
ivorysql.conf" (just the filename, no article or plural)
Positive note: Unlike the Chinese version, the English version correctly uses the plural form shared_preload_libraries for the GUC parameter name. ✅
Summary: The file wasn't skipped from review; the change was very small. However, the addition of "files" should be reconsidered for clarity.
1 participant
Summary by CodeRabbit