新GNU维护人员的提示
如果您是维护GNU包的新手提供给GNU或您已经采用的现有GNU,可以是不知所措,不知从哪里开始。官方电子邮件通知您当你成为GNU维护者时收到的信息有很多细节;这该文档不是该电子邮件的替代品,而是一种补充,旨在提供一些入门技巧。
当然,这里列出的只是GNU的表面维护人员。请务必阅读GNU维护人员指南和GNU编码标准的确,你应该已经读过了,但它们写得足够仔细重新阅读很有用。此外,一些经验丰富的GNU贡献者自愿通过以下方式回答有关GNU维护的问题<导师@gnu.org>以及<maintainers@gnu.org>.
新维护人员的第一步
这些任务按优先级列出。标签([全部],[新增]、和[通过])指明包裹的类别每个任务主要适用于。
- [全部] 更新上的项目信息大草原。转到项目页面(
https://sv.gnu.org/projects/PKG
,其中PKG是您的包),使用您的Savannah ID登录,并在“更新公共“Main”(主)菜单中的“info”(信息)。在这里,您应该设置项目的全名,如果需要,写一个简短和长的描述它(也请将这些描述发送给<maintainers@gnu.org>供使用在以下列表中所有GNU包装). 您还应该设置其开发状态以反映代码的成熟度。如果你有采用了一个包裹,因为它将被标记为“孤儿”。
- [全部] 翻到邮件列表。如果你有一个新的GNU包,您应该为软件包(主菜单中的“选择功能”)。它很强大建议打一个电话<bug-PKG@gnu.org>;其他人可以等到交通许可证。如果你已经采用了现有的套餐,请发送电子邮件介绍你自己。最后,无论列表是新创建的还是已经存在的,不要忘记自己订阅,因为这不是自动完成的。(关于处理邮件.)
- [新增] 为源设置存储库代码(主菜单中的“选择功能”),然后导入任何可用的(在“源代码”下查找过程“开发工具”部分中的“管理器”)。经验表明这种自托管是不可靠的。(关于备份文件夹.)
- [新增] 将包上传到GNU FTP网站如果可以公开发布。(关于上传程序.)
- [新增] 创建GNU主页,以替换这个
PKG.html(PKG.html)
网站管理员放置在您的网络回购中的文件(保持相同的名称)。如果你想让这件事变得简单快捷,请使用我们的标准模板.注释如果该项目刚刚开始;你稍后会完成它们。也可以放任何在名为“手动”。(关于网页.)
- [通过] 检查现有错误报告如果您采用了现有的包。这些可能在任何或所有Savannah bug tracker上邮件列表(mbox存档可以是由下载HTTPS协议),或GNU去bugs服务器(关于回复错误报告.)
- [通过] 联系发行包装商。如果你已经收养了一个现有的包,它在下游发行版中可用,请进入与包装商联系。很可能他们有未解决的错误需要解决的报告,甚至可能需要应用。您可能还想参与GNU吉他包管理器。(关于发行版.)
- [通过] 使用软件。不用说,如果你已经采用了GNU包,您应该使用它来感受它当前状态并发现可能需要修复的问题。
- [全部] 选择一些任务并开始黑客攻击!花时间做实际工作是无可替代的。
维护GNU软件的一般技巧
- 以快速发布为目标。您的包裹是否新的或者你已经接受了一个旧的,你的首要任务应该是尽快发布第一个版本。如果你收养了包中,这足以修复一些错误并将其排除。事实上,只更新基础结构文件(例如,Autoconf/Automake、gnulib模块等)足以在您第一次发布时证明新版本的合理性接管一个包裹。如果你的包裹是新的,不要害怕把推出了一个尚未完成功能的早期版本。无论如何释放(带有适当的公告)将以以下形式提请注意您的包裹潜在用户甚至其他开发人员。这是让人们知道一个旧的包裹已经恢复或一个新的包裹根本不存在。(关于制作发布.)
- 首先集中精力修复未解决的错误。这真是太棒了开始学习新代码库并获得感受一下这个系统是如何工作的。此外,不应提供新功能如果已经存在显著的问题,则应予以高度关注。(关于GNU的资源开发人员.)
- 不要试图重写整个事情。如果你已经收养了我们强烈建议您不要重写整个程序从头开始。虽然总是很诱人,而且很容易开始,成功地完成它需要付出巨大的努力,并且经验表明,这几乎是一种必然的方式并导致项目最终(再次)停滞。相反,要关注增量改进。一旦你变成如果你对这个包裹非常熟悉,你就会处于一个更好的位置考虑更彻底的改变。
- 你负责!作为一名维护人员,您要照顾作为整个GNU项目的一部分。GNU取决于您照料合法的事项,发布新版本,保留网页已更新,回复错误报告并以其他方式与用户通信,处理修补程序适当地等等。这是你的特权责任。请帮助我们保持活跃和稳定的收藏软件。如果你有问题或遇到问题,不要不愿通过联系<maintainers@gnu.org>。(关于招募开发人员.)
- 参与进来。GNU完全由志愿者和你对组织的参与就是你的功劳!作为一个维护者,从我们那里收到的信息(读作:纠缠)将是低容量。积极参与GNU是提高您接触和接触其他志同道合的志愿者。如果您发现您希望参与的GNU方面,几乎有当然还有贡献的空间。(关于帮助GNU和自由软件.)
以最后一次重申来结束此列表:信息和上面的链接只是一个示例。请参阅并(重新)阅读全文GNU维修人员信息和GNU编码标准大量文件更多信息。
GNU理念
这似乎也是一个合适的页面,可以在上面提供一些链接GNU和自由软件的基本思想: