Skip to content

Conversation

@OreoYang
Copy link
Owner

@OreoYang OreoYang commented Oct 14, 2025

Summary by CodeRabbit

  • Documentation
    • 新增关于 Oracle 兼容 NLS 参数及其运行/格式行为的详细文档。
    • 更新欢迎页措辞与排版,并对若干版本文档做文字/格式微调。
  • Chores
    • 添加统一的自动审查配置(语言设为 en-US,启用自动审查并设置审查策略)。
    • 新增文档 CI 流程以验证 AsciiDoc 语法并执行内部链接检查。
    • 移除 PR 预览的自动构建与部署工作流。

@coderabbitai
Copy link

coderabbitai bot commented Oct 14, 2025

Walkthrough

Adds 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

Cohort / File(s) Summary
Code review configuration
.coderabbit.yaml
Added CodeRabbit configuration with schema reference, language en-US, reviews (profile: "chill", high_level_summary: true) and auto_review enabled (drafts: false, base_branches: ["master","v4.6","v4.5","v1.17","auto_review"]).
CI: AsciiDoc review workflow (added)
.github/workflows/adoc-review.yml
Added "AsciiDoc Review" workflow triggered on pushes/PRs touching .adoc/.asciidoc; sets up Ruby 3.2 with Bundler cache, installs Asciidoctor + diagram support, validates AsciiDoc (strict), sets up Node.js 18, configures and runs asciidoc-link-check via npx with a generated .asciidoc-link-check.json, and skips gracefully if no AsciiDoc files exist.
CI: PR preview workflow (removed)
.github/workflows/pr-preview.yml
Removed the PR preview workflow that previously built/deployed documentation previews (Antora builds, Netlify deploys, PR preview comments).
Documentation: NLS feature and implementation (new)
CN/modules/ROOT/pages/master/6.3.5.adoc
Added a Chinese documentation page describing Oracle-compatible NLS parameters and implementation details (GUCs like datetime_ignore_nls_mask, nls_* formats, nls_length_semantics, typmod/parser interactions, binding/ORA compatibility, runtime effects). Documentation-only.
Documentation: 6.4 edits (CN & EN)
CN/modules/ROOT/pages/master/6.4.adoc, EN/modules/ROOT/pages/master/6.4.adoc
Minor textual/formatting edits: CN file spacing/punctuation adjustments; EN file updated a reference phrase about gb18030_2022 location. No functional changes.
Documentation: welcome text small edit (EN)
EN/modules/ROOT/pages/master/welcome.adoc
Minor wording/tense change and insertion of a short standalone line; no behavioral or API 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)
Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Poem

我是小兔巡文档,
新规配置悄然添。
链接核查跑得欢,
NLS 描述入中文版,
合并时节笑声甜 🐇✨

Pre-merge checks and finishing touches

❌ Failed checks (1 inconclusive)
Check name Status Explanation Resolution
Title Check ❓ Inconclusive The title “Auto review” is overly generic and does not clearly communicate the main changes in the pull request, which include introducing a .coderabbit.yaml auto_review configuration, adding an AsciiDoc review GitHub Actions workflow, removing the PR preview workflow, and updating documentation files. Consider renaming the pull request to explicitly summarize the key updates, for example “Add AsciiDoc auto-review workflow and update .coderabbit configuration,” so that the title conveys the scope of the changes.
✅ Passed checks (2 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Docstring Coverage ✅ Passed No functions found in the changes. Docstring coverage check skipped.
✨ Finishing touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch auto_review

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

📜 Review details

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between b60867a and 9359d32.

📒 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

Comment on lines +23 to +29
- name: Cache gems
uses: actions/cache@v3
with:
path: ~/.gem
key: ${{ runner.os }}-gems-${{ hashFiles('**/Gemfile.lock') }}
restore-keys: |
${{ runner.os }}-gems-
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major

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.

Suggested change
- 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.

Comment on lines +36 to +73
- 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
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major

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.

@OreoYang OreoYang closed this Oct 14, 2025
@OreoYang OreoYang reopened this Oct 14, 2025
Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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: true
CN/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

📥 Commits

Reviewing files that changed from the base of the PR and between 9359d32 and 0741317.

📒 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)

Comment on lines +5 to +9
branches: [main, master]
paths: ['**.adoc', '**.asciidoc']
pull_request:
branches: [main, master]
paths: ['**.adoc', '**.asciidoc']
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major

修正触发路径模式,确保在子目录下的文档变更能触发工作流

当前使用的通配符为 '.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.

Suggested change
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.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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

📥 Commits

Reviewing files that changed from the base of the PR and between 0741317 and f19d22f.

📒 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

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

📜 Review details

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between f19d22f and a972d80.

📒 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

Comment on lines 136 to 139
[NOTE]
====
`to_number()`函数尚未实现。傻大姐撒低级啊实打实
==== No newline at end of file
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

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.

Suggested change
[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.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

📜 Review details

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between a972d80 and 062fbd8.

📒 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
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major

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]


是的
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major

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.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

📜 Review details

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 062fbd8 and 0ae2538.

📒 Files selected for processing (1)
  • CN/modules/ROOT/pages/master/6.3.5.adoc (1 hunks)

====


还是大师啊时代是 No newline at end of file
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

删除文末的无意义文字。

“还是大师啊时代是”毫无语义且显得不专业,请删除或改成有意义的总结语句。

🤖 Prompt for AI Agents
在 CN/modules/ROOT/pages/master/6.3.5.adoc
第142行,行尾存在无意义文字“还是大师啊时代是”;请删除该短语或将其替换为一条有意义、专业的总结性语句(例如一句简短的归纳或过渡句),确保语句通顺且与前后内容衔接一致。

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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

📥 Commits

Reviewing files that changed from the base of the PR and between 0ae2538 and 633e501.

📒 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。
Copy link

@coderabbitai coderabbitai bot Oct 15, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major

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).

Copy link
Owner Author

@OreoYang OreoYang Oct 15, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@coderabbitai why EN/modules/ROOT/pages/master/6.4.adoc was skipped from review, please review it again.

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🧩 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.conf file" (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.

@OreoYang OreoYang closed this Oct 17, 2025
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