(hugegraph-doc) branch master updated: docs: explain Store callbacks and CI policy (#513)

[ji...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

imbajin pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/hugegraph-doc.git


The following commit(s) were added to refs/heads/master by this push:
     new 0bf6069a8 docs: explain Store callbacks and CI policy (#513)
0bf6069a8 is described below

commit 0bf6069a8c28edc1577bad7184375996add0495f
Author: imbajin <ji...@apache.org>
AuthorDate: Mon Oct 12 23:25:50 2026 +0800

    docs: explain Store callbacks and CI policy (#513)
    
    - clear required deployment check contexts
    - retain existing pull request review protection
    - keep site build and preview workflows running
---
 .asf.yaml                                                |  3 +--
 content/cn/docs/quickstart/hugegraph/hugegraph-hstore.md |  8 ++++++++
 content/en/docs/quickstart/hugegraph/hugegraph-hstore.md | 11 +++++++++++
 3 files changed, 20 insertions(+), 2 deletions(-)

diff --git a/.asf.yaml b/.asf.yaml
index a97ff3042..abcead672 100644
--- a/.asf.yaml
+++ b/.asf.yaml
@@ -42,8 +42,7 @@ github:
   protected_branches:
     master:
       required_status_checks:
-        contexts:
-          - deploy
+        contexts: []
       required_pull_request_reviews:
         dismiss_stale_reviews: true
         required_approving_review_count: 1
diff --git a/content/cn/docs/quickstart/hugegraph/hugegraph-hstore.md b/content/cn/docs/quickstart/hugegraph/hugegraph-hstore.md
index 39d0f2290..d4c326ccc 100644
--- a/content/cn/docs/quickstart/hugegraph/hugegraph-hstore.md
+++ b/content/cn/docs/quickstart/hugegraph/hugegraph-hstore.md
@@ -221,6 +221,14 @@ Store 从 `conf/` 读取两个配置文件。1.7.0 发布标签的源文件见 [
 | `thread.pool.scan.max` | `1000` | 扫描最大线程数。 |
 | `thread.pool.scan.queue` | `0` | 扫描任务队列容量。 |
 
+**gRPC 回调队列（1.8.0）**
+
+Store 使用无界队列处理 gRPC 回调，避免队列满时丢弃取消或完成通知，导致请求无法正常结束。`thread.pool.grpc.queue` 仍可写在配置中，但不再限制这个队列的容量。
+
+`thread.pool.grpc.core` 和 `thread.pool.grpc.max` 仍用于配置线程池。由于回调可以继续排队，积压通常不会触发线程数从 `core` 增长到 `max`；只增大 `max` 无法提高回调处理能力。
+
+持续过载仍会使队列积压并增加内存占用。应限制客户端并发，并根据节点资源调整扫描和查询工作线程池；不要依赖 `thread.pool.grpc.queue` 限流。1.7.0 仍使用配置的 gRPC 队列容量。
+
 **查询下推**
 
 | 配置项 | 代码默认值 | 说明 |
diff --git a/content/en/docs/quickstart/hugegraph/hugegraph-hstore.md b/content/en/docs/quickstart/hugegraph/hugegraph-hstore.md
index 38168f28d..27dca0e2a 100644
--- a/content/en/docs/quickstart/hugegraph/hugegraph-hstore.md
+++ b/content/en/docs/quickstart/hugegraph/hugegraph-hstore.md
@@ -222,6 +222,17 @@ Any other option defined in `org/apache/hugegraph/rocksdb/access/RocksDBOptions.
 | `thread.pool.scan.max` | `1000` | Maximum scan threads. |
 | `thread.pool.scan.queue` | `0` | Scan task queue capacity. |
 
+**gRPC callback queue (1.8.0)**
+
+Store uses an unbounded queue for gRPC callbacks so that a full queue does not discard cancellation or completion notifications and leave requests unfinished.
+You can keep `thread.pool.grpc.queue` in the configuration, but it no longer limits this queue.
+
+`thread.pool.grpc.core` and `thread.pool.grpc.max` still configure the thread pool. Because callbacks can continue to queue, a backlog normally does not grow
+the pool from `core` to `max`; increasing `max` alone does not increase callback processing capacity.
+
+Sustained overload can still grow the queue and increase memory usage. Limit client concurrency and size the scan and query worker pools for the node's
+resources; do not rely on `thread.pool.grpc.queue` for load control. Version 1.7.0 still uses the configured gRPC queue capacity.
+
 **Query pushdown**
 
 | Key | Code default | Meaning |