规范杂谈

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

?
image

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

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

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

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

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

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

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

什么是规范呢?

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

规范有哪些

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

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

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

代码提交规范

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

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

格式规范:

  • Bug修改类:

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

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

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

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

为什么很有必要?

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

image

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

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

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

  • 今年完成了什么项目?

  • 修改了哪些bug;

  • 哪些bug让你印象深刻;

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

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

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

最后编辑于
?著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 214,128评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,316评论 3 388
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事?!?“怎么了?”我有些...
    开封第一讲书人阅读 159,737评论 0 349
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,283评论 1 287
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,384评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,458评论 1 292
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,467评论 3 412
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,251评论 0 269
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,688评论 1 306
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,980评论 2 328
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,155评论 1 342
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,818评论 4 337
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,492评论 3 322
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,142评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,382评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,020评论 2 365
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,044评论 2 352

推荐阅读更多精彩内容

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