社区与采用衡量一个项目是否拥有用户与关注,以及是否具备欢迎贡献者的配置。采用本身就是证据:被广泛安装的软件经受了更多环境、更多边界情形与更多目光的检验,远胜无人运行的软件——而一个为接纳贡献者做好准备的项目,能把这种关注转化为维护能力。
该类别承载总健康指数的 18%。
本类别包含的指标
流行度按对数尺度读取 GitHub 上的关注度—— 星标、复刻、关注者。社区健康是一份清单,核查使参与成为可能的文件:README、许可证、贡献指南、行为准则、议题与 PR 模板。生态采用则越过 GitHub 直达软件包注册表——在那里,真实的下载量作为采用信号胜过星标。
如何解读类别数值
- 注册表下载量的分量高于星标。星标度量关注,下载量度量使用。一个星标不多但每月安装量达百万的软件包,比一个无人依赖的爆红仓库承载着更重的实际负荷。
- 不发布软件包的仓库不会被扣分:其生态采用为
null,类别权重重新归一化到其余两项指标之上(参见 受支持的生态系统)。 - 小而健康是可见的。社区健康清单不依赖规模,因此贡献者基础设施完备的年轻项目,在采用到来之前就能获得良好读数。
提升社区与采用
- 补齐参与所需的文件:README、LICENSE、CONTRIBUTING、行为准则与议题/PR 模板各自承载有明确记录的权重。
- 将软件包发布到所属生态的注册表,并保持软件包的仓库链接准确—— 只有当软件包可验证地指回仓库时,采用证据才被计入。
- 流行度随使用而来;持久的抓手是让项目易于采用、易于查阅文档、易于贡献。