下一节:,上一节:,上一级:团队协调员   [目录][索引]


3.4 CVS 提交及最佳实践

由于所有团队负责人都有权写入 ‘www’ 项目的 CVS 存储库,这意味着他们技术上可以修改其中的每个文件。这种信任不应被滥用——团队协调员应该添加/更新的唯一文件是那些与其翻译工作相关的文件。修改原文中的明显错别字是可以的;对于其他任何情况,请报告给 [email protected]

如果您希望自愿担任网站管理员,并帮助处理通用的网站管理员工作和 RT 工单,那非常好——请遵循已建立的(由 GNU 网站管理员)程序。如果您的申请获得批准,您可以戴上您的“网站管理员帽子”来修改这些页面。

如果某个特定页面的标记存在问题,给您的语言造成问题,请通知 [email protected]。对于影响更多文章的一般性问题,或者严重问题,请写信给 [email protected]

如果您不熟悉 CVS,建议阅读 CVS 手册,以便基本了解此 VCS 的工作原理。请参阅 使用 CVS 进行版本管理 中的 并发版本系统。没有必要成为专家——‘www’ 项目不使用诸如标签、供应商分支、合并等复杂功能,因为它们对于实时网站不是很有用。

然而,您可能需要学习如何有效地使用 CVS——从历史记录中提取信息、查看差异和特定更改、与团队(如果有)的工作存储库同步、添加/删除文件等。

如果您进行的更改影响多个文件但更改是连贯的,请将其作为一次提交进行。这将只向 [email protected] 生成一条消息,这比 5 个文件关于语义相同更改的 5 条消息要好。始终以英语3编写提交日志,并简短描述更改。如果您修改的文件不是文章,而是脚本或软件的一部分(例如 server/gnun/gnun.mk),最好遵循 GNU 编码标准并精确描述更改(请参阅 GNU 编码标准 中的 变更日志)。例如,不要写

Added support for Nepali.

Yay!  First commit of the Panjabi homepage!

而是像下面这样写日志

(TEMPLATE_LINGUAS): Add `ne'.

(FUZZY_DIFF_LINGUAS): Add `pa'.

这使得其他人更容易在历史记录中搜索特定的更改。

如果您添加二进制文件(例如,.png),请使用 cvs commit -kb file 进行提交。这将关闭关键字替换,从而防止 RCS 关键字(如 ‘$Id$’)被扩展,随后损坏该文件。请参阅 使用 CVS 进行版本管理 中的 替换模式。更重要的是,使用 -kb 可以防止在使用臭名昭著的操作系统下的 CVS 客户端的人签出、修改文件,然后提交时,二进制文件被行尾搞乱而损坏。4

尽管不是绝对强制的,但建议每个团队负责人都订阅 [email protected]。如果您在提交前检查差异时遗漏了某些内容,那么检查您自己的消息的差异很有用。在任何情况下,团队负责人都应该订阅该列表,以避免他自己的提交消息被审核。如果您绝对不希望接收所有流量,只需在 Mailman 的用户界面中禁用邮件传递即可。


脚注

(3)

此建议仅适用于 ‘www’ 存储库——在团队的存储库中提交时,请随意使用您的母语编写日志。

(4)

几年前,仍然有提交者使用非自由操作系统——我们不规定人们使用什么操作系统,但我们至少可以防止这种技术性的损害。


下一节:利用 Savannah,上一节:同行评审,上一级:团队协调员   [目录][索引]