您如何处理不再维护的 GitHub 存储库?
无论出于何种原因,一个项目都是从 GitHub 存储库开始的,然后某个时候它被放弃了,也许这是一个没有成功的实验。也许您将其替换为商业产品。或者,也许您找到了一个与您正在做的类似的项目,并加入了他们的努力。
在您的存储库还活着的时候,它吸引了观察者和一些分叉。
那时你会用它做什么?有没有办法很好地表明不再维护存储库并检查分叉或不同的项目?
您如何处理不再维护的 GitHub 存储库?
无论出于何种原因,一个项目都是从 GitHub 存储库开始的,然后某个时候它被放弃了,也许这是一个没有成功的实验。也许您将其替换为商业产品。或者,也许您找到了一个与您正在做的类似的项目,并加入了他们的努力。
在您的存储库还活着的时候,它吸引了观察者和一些分叉。
那时你会用它做什么?有没有办法很好地表明不再维护存储库并检查分叉或不同的项目?
Actually, I think pretty much the nicest thing you can do is to simply delete the repository. That way, the obsolete code doesn't show up in searches, for example.
The whole point of distributed version control is that no single repository is more important than another. If there is enough interest in the project, then one of the people who forked the repository will emerge as the new community leader. And if nobody forked it, then it probably wasn't worth preserving anyway.
我会做一个单独的提交,删除所有源,除了一个 README 文件,它清楚地表明你不再对项目感兴趣(也将 README 的重要部分复制到最后的提交日志消息,使用 git commit --必要时修改)。
自述文件应说明所有源代码仍可作为历史记录使用。此外,还应针对成熟度级别描述最新代码的状态:如果它在某处生产中使用,则应在此处说明。如果这只是一个实验,而您从未正确编译过它,那么应该用大写字母表示。不过,在后一种情况下,仅删除代码存储库可能是有意义的。
显然,自述文件还应该包含对代码功能的一般描述,但这应该已经在自述文件中。
还要尝试在自述文件中添加一些您希望该代码的潜在用户寻找的词。尝试将这些词放在表明您不再维护代码的部分附近。
这样做的原因:
我不同意如果没有人分叉(并保留代码),那么它一文不值的建议。也许其他人没有接管的唯一原因是你的项目没有被足够多的眼球看到。
如果你认为你的代码有任何价值(我的意思是任何高于零的值),那么不要删除它。只需明确说明代码已被放弃即可。
I prefix my projects with "deprecated." There are some posts on github's site regarding this, but it seems they won't budge. They want you to put a note in the readme. I'd prefer to put information in a relational database so you can sort on different fields, one of those being if the project is active or not.
I put my deprecated projects up there because there are concepts you can re-use. It is similar to your school work. Hopefully you can learn a lesson or 2 from it.
Walter
我会在 README 文件中做出一个很好的提交,该文件基本上说明这是为了历史参考,查看 XY 和 Z 以了解这段代码的去向。