📌 项目地址gsd-build/get-shit-done | ⭐ 63,773 颗星 | 🔧 JavaScript | 📜 MIT

事情本身

gsd-build/get-shit-done,JavaScript 项目,63773 颗星。README 只有一段话:这个仓库不再是 GSD 的开发主仓库,项目改名为 GSD Core,搬到了 open-gsd/gsd-core。源码、issue、release、贡献,一律去新地址。

没有功能介绍,没有安装命令,没有使用示例。我没法介绍这个工具本身,仓库里没有这个材料。能写的只有这颗 63773 和它挂着的空壳。

我发现问题的方式

刷 GitHub 首页,看到 6 万星的项目,第一反应是收藏。点进去,README 第一句就是 “This repository is no longer the active home for GSD development”。手停住了。

有个细节:这个仓库没有归档。GitHub 的 Archive 功能会在页面顶部显示红色只读横幅,访客一眼就知道项目停了。GSD 旧仓库没做这一步,页面看起来一切正常,星数照涨。

所以现在这个 63773 里,有一部分是在项目迁走之后、在错误地址上点下的。GitHub 不区分这两种星。

两分钟判断一个仓库死没死

这件事之后我给自己定了个流程,四个动作:

  1. README 第一屏扫关键词:moved、deprecated、no longer maintained、unmaintained。出现任何一个,先停下确认。
  2. 看有没有归档横幅。归档了可以直接走人;没归档不代表还活着。
  3. 看 Commits 最近时间。这个仓库的提交早停了,新仓库还在更新。
  4. 看 Releases。长期不发版,基本等于没人维护。

四步走完,比看星数准。

维护者欠两个操作

项目搬家很正常,收尾没做完:

  • 归档仓库。点一下 Archive,红色横幅立刻出现,成本五分钟。
  • 不归档的话,至少在新仓库 README 里回链旧仓库,写清迁移历史,方便后来者核对。

不做这两件事,结果就是每天有人在错误的地方点星、clone 旧代码、往没人看的 issue 区发帖。旧仓库的星数,某种意义上是这笔欠账的利息。

我做了什么

取消了旧仓库的星标,给 open-gsd/gsd-core 点了一颗。想用 GSD 的人,直接去那边。

以后再看到高星仓库,先跑一遍那四步。星数回答的是“这个项目曾被多少人看过”,不是“今天还能不能用”。这两个问题,经常不是同一个答案。

这篇文章对你有帮助吗?

发表回复