Skip to content

Latest commit

 

History

History
37 lines (32 loc) · 1.19 KB

openSourceSpecification.md

File metadata and controls

37 lines (32 loc) · 1.19 KB

开源规范

  • 非编码类规范

    • 开源规范
    • 文档规范
    • 版本规范
    • Commit规范
    • 开发流程规范
    • 发布规范
  • 编码类规范

    • 目录规范
    • 代码规范
    • 接口规范
    • 日志规范
    • 错误码规范

开源规范

开源协议的各种规范,各种限制看这张图就足够了。

下面是项目,特别是开源项目,需要具备的规范。

  • 项目结构合理
  • 严格遵守代码规范,比如变量的命名,
  • 代码的质量:比如良好的算法,运用得当的设计模式,合理的代码长度
  • 单元测试覆盖率要高
  • 版本发布要规范,遵守版本的标号,例如 v1.1.3 , 要有版本号文件,通常是 CHANGELOG.md
  • 向下兼容,高版本要兼容低版本的东西
  • 详细的文档说明
  • 安全的代码,不要出现涉密的内容,比如内部的密码等
  • 完善的example,好的example胜过文档说明
  • 良好的Commit 提交规范
  • 保证项目的可用性,每一个版本都要经过严格的测试才能放出来
  • 及时处理 requests
  • 做好推广以及讨论小组
  • 遵守git规范