项目过程管理(十)开发规范

栏目: 编程工具 · 发布时间: 5年前

内容简介:git的用户名为自己名字的小写全拼,邮箱为公司邮箱,方便追溯提交者。命令行操作示例:分支管理请参考《Git分支管理规范》。

git的用户名为自己名字的小写全拼,邮箱为公司邮箱,方便追溯提交者。命令行操作示例:

git config --global user.name myname
git config --global user.email myemail@example.com

git commit 的log原则:

  • 必须说明提交的意义,不能是简单无意义的文字
  • bug fix应写上是解决哪个bug,可复制禅道上的ID和标题
  • 做需求应写是哪个需求;分批提交应写上完成了什么具体内容

分支管理请参考《Git分支管理规范》。

代码规范

各技术组自己决定代码风格规范,可参考google、apple、facebook、alibaba、airbnb、microsoft任一家的。并可找些自动格式化和检查 工具 作为辅助。例如移动开发可参考 《移动开发代码规范与格式化工具》

代码的文件组织(目录结构)规范应在 README.md 中说明。

文档规范

新项目必须画系统架构图、网络拓扑图等宏观设计的图,便于新同学或测试组同学理解。无论在哪里写的,最后都应该复制一份一同提交到代码仓库。

好的代码应该只需要描述宏观架构和设计思路就能让新人上手,细节的设计是通过代码注释和增强代码可读性来体现的。快速的迭代节奏不会有时间写详细设计,且变化太快也来不及更新文档。

README.md (代码说明)还可以包括这些内容:

  1. 迭代历史
  2. TODO list
  3. 工具使用说明
  4. 第三方依赖的参考文档URL
  5. 特殊的设计、约定
  6. 项目关联的文档地址,例如需求文档、服务器接口文档等
  7. 各种系统的一些公用的低机密性账号密码

前后端合作都以API为媒介,所以API文档是必须的。怎么设计API规范,可参考 《Web API规范设计指引》

Review制度

哪些情况应该主动请求review:

  • 有可能破坏了整体的设计风格、规范
  • 代码所属的功能非常重要,出错的话会造成公司业务重大损失
  • 改动范围很大,会改到另外2个或以上同事写的较多代码

本节参考

本系列文章的目录: https://hursing.blog.csdn.net/article/details/88025790


以上所述就是小编给大家介绍的《项目过程管理(十)开发规范》,希望对大家有所帮助,如果大家有任何疑问请给我留言,小编会及时回复大家的。在此也非常感谢大家对 码农网 的支持!

查看所有标签

猜你喜欢:

本站部分资源来源于网络,本站转载出于传递更多信息之目的,版权归原作者或者来源机构所有,如转载稿涉及版权问题,请联系我们

分布式算法导论

分布式算法导论

泰尔 / 霍红卫 / 机械工业出版社 / 2004年09月 / 39.0

分布式算法20多年来一直是倍受关注的主流方向。本书第二版不仅给出了算法的最新进展,还深入探讨了与之相关的理论知识。这本教材适合本科高年级和研究生使用,同时,本书所覆盖的广度和深度也十分适合从事实际工作的工程师和研究人员参考。书中重点讨论了点对点消息传递模型上的算法,也包括计算机通信网络的实现算法。其他重点讨论的内容包括分布式应用的控制算法(如波算法、广播算法、选举算法、终止检测算法、匿名网络的随机......一起来看看 《分布式算法导论》 这本书的介绍吧!

HTML 编码/解码
HTML 编码/解码

HTML 编码/解码

Markdown 在线编辑器
Markdown 在线编辑器

Markdown 在线编辑器

UNIX 时间戳转换
UNIX 时间戳转换

UNIX 时间戳转换