9

Maven 支持<developers>with <roles>，但是，我没有看到有效角色的官方列表。

这些角色只是用于文档目的的纯文本吗？如果没有官方的角色列表可供选择，是否有关于如何格式化角色名称的规则或标准？

例如，UI 开发人员是 a uideveloper、 a ui-developer、 aUI Developer等。

4

3 回答 3

7

这就是我在 XSD 中看到的。角色只是一个普通的xs:string，它主要用于文档。

<xs:element name="roles" minOccurs="0">
  <xs:annotation>
    <xs:documentation source="version">3.0.0+</xs:documentation>
    <xs:documentation source="description">
        The roles the contributor plays in the project. Each role is described by a <code>role</code> element, the body of which is a role name. This can also be used to describe the contribution.
    </xs:documentation>
  </xs:annotation>
  <xs:complexType>
    <xs:sequence>
      <xs:element name="role" minOccurs="0" maxOccurs="unbounded" type="xs:string"/>
    </xs:sequence>
  </xs:complexType>
</xs:element>
于 2013-10-18T12:04:53.920 回答
3

据我所知，没有规则。这些是简单的测试，用于html在调用site目标时生成。结果生成这样team-list的HTML 页面。

我建议使用人类可读的文本。

它是自由文本且未经检查，因为想象一下 Apache Maven 人员是否必须保留所有可能职位/角色的列表并维护它们。这将是一项巨大的努力，因为不同的公司往往对同一个角色有不同的头衔。

于 2013-10-18T12:46:33.823 回答
3

这不适用于特定的开发人员列表。它用于提供有关参与该项目的开发人员的信息。没有必要有您可以从中选择的特定列表。它主要用于文档。

所有项目都包含在某个时间由一个人创建的文件。就像围绕项目的其他系统一样，参与项目的人在项目中也有利益关系。开发人员大概是项目核心开发的成员。请注意，虽然一个组织可能有许多开发人员（程序员）作为成员，但将他们全部列为开发人员并不是一种好的形式，而仅列出直接对代码负责的人员。一个好的经验法则是，如果不应就项目联系此人，则无需在此处列出。

参考http://maven.apache.org/pom.html#Developers

于 2013-10-18T12:04:38.340 回答