MS RFC 7.1:MapServer SVN提交管理

日期

2008／07／02

作者

弗兰克·温默丹和汤姆·克莱迪斯

联系方式

可在Pobox.com上了解更多有关Warmerdam的信息；可在hotmail.com上了解更多有关Tomkralidis的信息

状态

采用

注解

这个RFC废弃了 MS RFC 7:MapServer CVS提交管理 .

目的

规范SVN提交访问，并为SVN提交者指定一些指导原则。

选择SVN提交访问

只有在MapServer项目指导委员会接受的情况下，才应向新开发人员提供SVN提交访问权限。一个建议应该写给PSC的新委员，并正常投票。没有必要为这些投票写一个RFC文档…给mapserver dev发电子邮件就足够了。

删除SVN提交访问应该由同一进程处理。

新的提交者应该表现出对MapServer的承诺以及对MapServer源代码和流程的了解，以使委员会满意，通常通过报告票据、提交补丁和/或积极参与各种MapServer论坛。

新提交者还应准备好支持他/她在未来版本中提交给MapServer源代码树的任何新特性或更改，或者如果他/她停止支持他/她负责的代码部分，则应找到负责这些特性或更改的人。

所有提交者也应该是mapserver dev邮件列表的成员，这样他们就可以随时了解策略、技术开发和发布准备。

提交者跟踪

所有项目提交者的列表将保存在每个SVN提交者的MAPServer目录（称为提交者）列表中：

  • userid：将出现在此人的SVN日志中的ID。

  • 全名：用户的实际名称。

  • 电子邮件地址：可以联系提交者的当前电子邮件地址。它可能会以正常的方式改变，使自动收割更加困难。

  • 职责范围的简要说明。

SVN管理员

项目指导委员会的一名成员将被设计为SVN管理员。该人员将负责授予SVN提交权限，更新提交者文件，以及其他与SVN相关的管理。最初，Steve Lime将担任SVN管理员。

SVN提交实践

以下是MapServer项目的良好SVN提交实践。

  • 对SVN提交日志项使用有意义的描述。

  • 在提交与Trac中的票据相关的更改时，在SVN提交日志条目的末尾添加票据引用，如“（1232）”。

  • 在讨论代码库的相关更改时，请将诸如“R7622”之类的变更集修订号包括在票据中。

  • 在历史文件中包含一个条目，用于主MapServer源树中提交的任何重大更改或修复。请确保将其放在正确的版本标题下，并在这些消息中包含票据编号。

  • 如果没有相应的票据和历史记录条目，则不应在稳定的分支中提交更改。任何值得推进到稳定版本的变化都值得一张跟踪记录单和良好的历史记录。

  • 永远不要向稳定的分支提交新特性：只有关键的修复。新特性只能放在主开发主干中。

  • 在预发布代码冻结期间，只应对代码提交票据缺陷。

  • 在进行主要开发版本的重大更改之前，应该在-dev列表中进行讨论，而较大的更改将需要PSC批准的RFC。

  • 未经PSC批准，不得新建分支机构。假定发布管理器具有创建分支的权限。

  • SVN中的所有源代码都应该是UNIX文本格式，而不是DOS文本模式。

  • 在提交新特性或对现有源代码进行重大更改时，提交者应采取合理措施，确保源代码继续在最常用的支持平台（当前为Linux和Windows）上构建和工作，可以直接在这些平台上进行测试，也可以从其他正在工作的开发人员那里获得帮助。在那些平台上。如果添加了新文件或库依赖项，则configure.in、makefile.in、makefile.vc和相关文档应保持最新。

投票历史

于2008/07/02通过，来自Periclesn、Danielm、Tamass、Jeff、Umberton、Stevew、Assefay、Frankw、Tomk。