docs: refresh ecosystem evidence and clarify adopter registration - #4710
Conversation
Signed-off-by: huangruiteng <14976749+huangruiteng@users.noreply.github.com>
huangruiteng
left a comment
There was a problem hiding this comment.
Approval conclusion (author-owned PR; GitHub blocks formal self-approval)
Reviewed head: 3502a8677bbdd53197f2fd330b262679df4a1245.
动机
生态清单仍使用 8 月 15 日状态,空的自愿登记表容易被误读为没有公开使用。本次完整更新四份中英文文档,让读者从 ADOPTERS 直接找到当前公开证据,同时保留由项目本人登记的边界。
改动思路
复用现有生态清单集中维护观察记录;ADOPTERS 负责解释登记状态并链接分类入口。来源正文、实际合并标记及后续评论决定条目状态。正向路径是“登记页 → 工作流/集成分类 → 原始证据”,不产生代登记,也不引入新目录或运行时权威。
具体改动
关键内容讲解
ADOPTERS.md与docs/project/adopters.zh-CN.md:补充双语导航、分类链接和空表说明;维持原有自愿登记规则。docs/community/ecosystem-adoption.md与中文版本:同步 31 条记录、48 个外部证据 URL,区分工作流/集成、机制借鉴、提案、教学传播和衍生实现。- 纠正 OpenBitFun 后继 PR 仍开放、RLR 后续 PR 和 GovernLoop 提案已关闭未合并等状态;KiroCrew/multica 保留“仅文档”,AAOP 保留非生产试点限制。
- 后续维护简化已落实:不在 ADOPTERS 复制项目表,移除易过期的 stars 与旧 fork 列表。四份 Markdown 合计 +362/-229;没有可执行代码变化。
对主干的风险
主要风险是将关闭未合并的提案、文档借鉴或作者自述误写为生产采用。逐项状态和限制说明覆盖这些反例;第三方运行结果仅按作者报告引用,未声称独立复现。外部链接及状态仍可能在复核日期后变化,可同步更新两种语言或回退此文档提交。
验证通过:文档治理 smoke;29 个相对链接/锚点;双语 48 个外部 URL 与 31 条记录一致;公开来源和当前合并状态回读;四份文档的公开/私有边界扫描;git diff --check;DCO;loopx canary premerge --from-git-diff 的 3 项直接检查、3 项目录 canary、8 项风险 smoke 和边界扫描;精确范围质量凭据有效。宽范围检查另有两项既有全局状态警告,与本 diff 无关。无必需检查失败或跳过,无人工保留项。按已解析策略不查询或等待 CI。
没有 CLI、前端包、运行时、持久状态、权限或默认行为变化;不涉及 typed-state、default-off 或运行时迁移契约。现有自报和观察证据边界保持不变;本次覆盖足以验证文档导航、来源一致性和状态表述,不认证第三方部署或性能。
我的整体评价
APPROVE。更新完成了当前文档目标,未发现阻塞项。它将可核查观察与自愿登记连接起来,没有把 31 条异质记录计为 31 个生产采用者。范围集中、可回退,属于仓库允许的低风险文档变更;合并仍须通过此未变更 head 的即时 readiness 检查。
English verdict: APPROVE - head 3502a86; the bilingual evidence refresh and adopter links preserve voluntary registration and source limitations. Documentation, link/parity, public-boundary, risk-based premerge and exact-scope quality checks passed; no runtime change or unresolved blocker.
Goal And Delivered Outcome
The ecosystem inventory still carried August 15 statuses, while the empty voluntary adopter table could be mistaken for an absence of public use. Refresh the bilingual inventory from public GitHub evidence and link the adopter pages directly to concrete workflows, integrations, borrowing and proposals.
The inventory now separates 31 entries by relationship and maturity. OpenBitFun's replacement PR, closed-unmerged proposals, bounded pilots and documentation-only borrowing retain their actual limits. The self-attested table remains voluntary; observed projects are not registered on their behalf. Base:
main.Scope And Continuation
Complete within this scope: four Markdown documents, with matching English/Chinese evidence links. No successor is needed for this documentation update; project owners may voluntarily add their own adopter entries later.
Future-facing simplification: keep observed evidence in the existing ecosystem inventory and link to it from ADOPTERS, rather than maintaining a duplicate project list. Remove transient star counts and obsolete fork listings. No new runtime or validation abstraction.
Validation
3502a8677bbdd53197f2fd330b262679df4a1245finishedpublic_fixturepython examples/docs-governance-smoke.pyloopx checkon the four changed documents: public boundary clean. The broader checker reported two unrelated existing global-state warnings.git diff --check; DCO sign-off present.loopx canary premerge --from-git-diff: docs_project_content/public_boundary selection; 3 direct checks, 3 catalog canaries, 8 risk-profile smokes and public-boundary scan passed; no failures.Coverage: validates the changed document navigation, bilingual source parity, public evidence boundaries and current cited statuses. Historical external tests and deployments were not reproduced. No manual hold for this scope.
Frontend / Visual Evidence
UI impact:
none. Secondary Markdown content and links only; no documentation chrome, public landing first viewport, application UI or packaged frontend change. Source data:public_fixture. Screenshots/viewports: N/A.Type of Change
LoopX Area
Technical direction / shared-authority RFC fixture impact: N/A; this is a community evidence refresh with no runtime or authority change.
Boundary Checklist
nonewith rationale.