成为代码提交者

Jul 10, 2017 10:38:44 AM

作者:zozohwendal

如果你已经是代码提交者

一定要注意

  • 请确保你修改的类上的 JDoc, 有你的大名,比如 "@author zozoh(zozohtnt@gmail.com)"
    • 首先,体现了你的贡献
    • 否则,出了问题,不知道由谁主要负责
  • 请尽量用统一的 code formatter, 导入 /nutz/doc/eclipse/nutz-eclipse-java-code-format-1.0.xml,否则我们同步代码是很难比较
  • 去掉的代码不要注释掉,直接删掉。我们会用文件比较工具比较两个版本的不同

你需要知道

  • Nutz 特点是代码短 (以不影响阅读为前提)
    • 无论任何时候,同样的功能,一段更短的代码,总比更长的代码要好
    • 这里的“短”,主要指的是“逻辑”短,而不是“字符长度”短
  • 如果你指出,某一个函数或者类其实无用,是最大的贡献
  • 删掉一段代码的贡献,比增加一段代码的贡献要大,至少不比它小
  • 如果你有机会能将代码减少一行,既不影响阅读,也不影响效率,你的贡献很杰出
  • 我希望代码越来越优美,我认为简单,直接,就是优美
  • 实现什么样的功能,由社区决定
  • 如何实现,由你决定
  • 如果有可能,请尽量为 public 的类和方法写 Java Doc,中文或者英文都可以
  • 主要的函数,需要由 JUnit 来保证质量
  • 你必须遵守这样的编码原则: 请阅读 Nutz Java 编码规范

关于代码重写

  • 接口的实现可以随时被重写,没关系,我们有版本控制,可以回滚
  • 你的每一次提交,必须都是编译通过的
  • 你的每一次提交,最好都是通过 JUnit 测试的
    • 除非有特别的情况 — 比如你要和其他人分享的修改
  • 我希望服务器上的代码通不过 JUnit 测试的情况,不要持续 3 天以上。最好,它时时刻刻都是可以通过全部 JUnit 测试的。

关于翻天覆地的重写

  • 这是不可避免的
  • 如果有充足的理由,我很高兴这样做
  • 我很喜欢我现在写出的代码,但是我不能保证一直喜欢它们
  • 实际上,我认为在相当长的一段时间里,我们没有精力维护两个或两个以上的版本,Nutz 应该只有 master

如果你不是,但是想成为代码提交者

  • 你需要申请加入社区, 请至 https://nutz.cn/ 发帖
  • 通过社区,你可以让我们了解你,如果你发的贴很有价值,我们会考虑邀请你成为代码提交者
  • 或者你可以直接给任何一个 Nutz 的代码提交者发信, 指出 Nutz 代码哪里存在不足,并提供修改建议。
    • 如果连续五次,你的修改建议被接受,我们会邀请你成为 Nutz 的代码提交者 — 当然你可以拒绝
  • 除此之外,没有其他的途径

本页面的文字允许在知识共享 署名-相同方式共享 3.0协议GNU自由文档许可证下修改和再使用。

原文: http://nutzam.com/core/committer/be_committer.html