为SWUpdate做贡献

欢迎贡献！请按以下指引进行贡献。

贡献检查列表

这些主要是一般性建议，在很多自由/开源项目中都是通用的。

  • 使用git管理你的更改[推荐]

  • 尽可能遵循内核代码风格[推荐] 然而，有些规则并没有内核中那么严格。 如果能增加代码的可读性，最大行长度可以扩展到80字符以上。

  • 将所需的版权头部信息添加到引入的每个新文件[必要要求]

  • 在所有补丁中添加签名信息(signed-off)[必要要求]
    • 用于证明”开发者的原始证明”, 请参阅下文
    • 当你并非独立工作时，请向你的雇主确认这些信息!
  • 增加你的补丁的版本，如果有后续版本需要的话 [推荐]
    • 在提交信息下添加 “Change from Vx” 描述，以跟踪补丁的历史
    • 建议使用优秀的 “patman” 工具管理补丁。这是U-Boot项目的一部分(tools/patman)， 但它也可以用于其他项目。

  • 检查以确认你的补丁没有破坏构建[必要要求] - 在 configs/ 目录下有一组配置文件

    请对目录中的所有文件运行构建，以确保SWUpdate仍然可以从与你的配置不同的配置中构建。

  • 将补丁发送到邮件列表[必要要求]
    • 使用 git format-patch 生成你的patch
    • 如果可能的话，使用 git send-email . 则可以避免可能由发件人带来的破坏
    • 如果补丁是针对Yocto的meta层，则添加前缀[meta-swupdate]
    • 将patch添加在正文，不要使用附件
    • 不接受 HTML 邮件!

  • 不要使用github Pull Request。本项目不使用github设施。 评审只在一个地方进行:邮件列表。github的PR将被忽略。

补丁由patchwork跟踪(参考 http://jk.ozlabs.org/projects/patchwork/). 你可以在此查看补丁状态 http://patchwork.ozlabs.org/project/swupdate/list.

开发者的代码签名证明1.1

当用如下形式对一个此项目的patch进行signing-off

Signed-off-by: Random J Developer <random@developer.example.org>

请使用你的真实名字(不要使用假名或匿名进行贡献)，并意味着你声明了:

通过对本项目的做出贡献，我证明:

  1. 贡献的全部或部分由我创建，我有权按照文件中所示的开源许可提交文件;或
  2. 贡献基于我所知的在适当的开源许可下涵盖的以前的工作， 并且我有权在该许可下提交该工作的修改，无论该修改是全部还是部分由我 在同一开源许可下创建的(除非我被允许在不同的许可下提交)，如文件中所示;或
  3. 这个贡献是由另一个人直接提供给我的，他证明了(a)、(b)或(c)，而我并没有修改它。
  4. 我理解并同意本项目及其贡献是公开的，且该贡献的记录(包括我随其提交的所有个人信息， 包括我的签名)将无限期地保留，并可能根据本项目或涉及的开源许可重新分发。