规范杂谈

文章首次整理发布个人博客一之笔:规范杂谈

image

这篇杂谈是脑子里回荡了很久,觉得有必要说一下;

最近感觉工作起来,越来越没有激情了;

作为公司唯一的IOS开发,还要兼顾APP的一些进展,鉴于公司的现实,产品,项目改了需求,或者计划,我从来都是后知后觉,我很不喜欢这种感觉,快2年来,历来都是参照Android的APP开发,公司项目整体一再delay,从未改观;

幸运的是,公司管理层,正在积极通过一些制度来改善当前的问题;

说了这么多,跟规范有什么关系呢?废话,当然有关系,规范是基础,是让所有人的力量往一处使;

规范,什么是规范?为什么要有规范?

大家都听过,无规矩不成方圆,国有国法,家有家规,公司部门应该也要有规范.

什么是规范呢?

规:从字面意思就是规定,规则,更深层次的来源就是,看这个字,左边是丈夫的夫,右下是一个儿子,古代女子嫁夫从夫,夫死从子,不难看出,这个字就是,你来了,你就得遵循我这儿的规矩
范:从字面意思就是,范围,模范
这俩字合起来就是,大家按照约定,彼此遵循的一个示范,用来约束大家的一种东西;
简言之,规范就是次一点的标准;
我们不搞标准,因为标准的定义太高了,所以我希望我们大家把自己部门的规范做好
另外,规范是大家制定的,也是需要大家遵守的,要不然,不执行,规范就是一纸空文;

规范有哪些

规范有研发部门通用规范,比如会议纪要当天写当天发,周报等;

部门规范,比如代码gerrit提交规范,内测发布规范;

跨组规范: API文档规范等等;

代码提交规范

这里简单分享一下APP组的提交规范

总要求:多笔提交,养成好代码提交习惯;

格式规范:

  • Bug修改类:

    • (项目名称)-FixBug:#编号-描述
  • 业务开发类:

    • ADD:(项目名称)-#(需求编号)小的功能就提交,项目初始化;
    • UPDATE:(项目名称)-(修改优化)描述
    • DELETE:(项目名称)-需求改动导致删掉或者注释掉部分代码;
    • OTHER:(项目名称)-(暂无)

为什么要考虑加一个项目名称?

因为每一笔代码提交都是你对公司的贡献,软件不像硬件或者其他部门,衡量软件开发的一个指标就是代码提交,可以不用很多,但是必须提交,并且每笔提交需要有对应的简述,让同伴知道你在做什么项目的什么功能;这很有必要;

为什么很有必要?

提交代码一般不写提交说明就提交上去了,我相信很多人都干过这事。比如这样的

image

有些人说,要说明好烦啊,我就不想写,不就是把代码f存在服务器吗?然而,仅仅是这样吗?

设想一下,有一天,你发现你的代码错了,你想把之前的那段代码找回来,可是,当我看着代码提交历史的时候,你根本不知道你要恢复到那一笔,是不是很恐怖的事,为了解决,你说,我重写一下,假如功能小还好说,如果是很大的功能呢,还有,你恢复一下,比你重写花费的时间少多了,不是吗?

还有你年终总结的时候,翻一番自己的提交历史,就知道你完成了啥;

  • 今年完成了什么项目?

  • 修改了哪些bug;

  • 哪些bug让你印象深刻;

是不是规范这东西,挺有用;

规范,就是用来约束你的行为准则,一旦公司有新成员进入,看看规范,立马就能融入到工作中,站在公司的角度,不会因为一个人的得失,而使得项目推进变得困难;

以上就是本次分享,谢谢观看;

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
【社区内容提示】社区部分内容疑似由AI辅助生成,浏览时请结合常识与多方信息审慎甄别。
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

相关阅读更多精彩内容

  • Swift1> Swift和OC的区别1.1> Swift没有地址/指针的概念1.2> 泛型1.3> 类型严谨 对...
    cosWriter阅读 13,904评论 1 32
  • 原题链接 思路:定义了一个函数,用来判断当前指针所指向的字符是不是一个需要判断的字符,然后两个指针从两端开始往中间...
    鬼鬼812阅读 631评论 0 1
  • 今天是套袋的第二天。虽然说累,人的身体已经慢慢适应。 他一共三浇地,浇浇地都管得很精细。这种映霜红桃一直到霜降才下...
    大唐王妃阅读 1,013评论 0 1
  • 人生因有梦想而辉煌,因追逐梦想而绽放!每个人都有自己的梦想,而当我们挤身于都市的茫茫人海,却不知不觉迷失了方向。每...
    山言良语lynn阅读 2,981评论 0 1
  • 这是一个很平凡的故事,却是一部很真诚的影片。 故事发生在绍兴的一个小城——台门。片名中的“西小河”,是绍兴西小路街...
    樱花屿鹿阅读 4,266评论 3 1

友情链接更多精彩内容