文章首次整理發(fā)布個(gè)人博客一之筆:規(guī)范雜談
?這篇雜談是腦子里回蕩了很久,覺(jué)得有必要說(shuō)一下;
最近感覺(jué)工作起來(lái),越來(lái)越?jīng)]有激情了;
作為公司唯一的IOS開(kāi)發(fā),還要兼顧APP的一些進(jìn)展,鑒于公司的現(xiàn)實(shí),產(chǎn)品,項(xiàng)目改了需求,或者計(jì)劃,我從來(lái)都是后知后覺(jué),我很不喜歡這種感覺(jué),快2年來(lái),歷來(lái)都是參照Android的APP開(kāi)發(fā),公司項(xiàng)目整體一再delay,從未改觀(guān);
幸運(yùn)的是,公司管理層,正在積極通過(guò)一些制度來(lái)改善當(dāng)前的問(wèn)題;
說(shuō)了這么多,跟規(guī)范有什么關(guān)系呢?廢話(huà),當(dāng)然有關(guān)系,規(guī)范是基礎(chǔ),是讓所有人的力量往一處使;
規(guī)范,什么是規(guī)范?為什么要有規(guī)范?
大家都聽(tīng)過(guò),無(wú)規(guī)矩不成方圓,國(guó)有國(guó)法马僻,家有家規(guī)磷杏,公司部門(mén)應(yīng)該也要有規(guī)范.
什么是規(guī)范呢对竣?
規(guī):從字面意思就是規(guī)定庇楞,規(guī)則,更深層次的來(lái)源就是否纬,看這個(gè)字吕晌,左邊是丈夫的夫,右下是一個(gè)兒子临燃,古代女子嫁夫從夫睛驳,夫死從子,不難看出膜廊,這個(gè)字就是乏沸,你來(lái)了,你就得遵循我這兒的規(guī)矩
范:從字面意思就是爪瓜,范圍蹬跃,模范
這倆字合起來(lái)就是,大家按照約定铆铆,彼此遵循的一個(gè)示范蝶缀,用來(lái)約束大家的一種東西;
簡(jiǎn)言之薄货,規(guī)范就是次一點(diǎn)的標(biāo)準(zhǔn)翁都;
我們不搞標(biāo)準(zhǔn),因?yàn)闃?biāo)準(zhǔn)的定義太高了谅猾,所以我希望我們大家把自己部門(mén)的規(guī)范做好
另外柄慰,規(guī)范是大家制定的,也是需要大家遵守的税娜,要不然坐搔,不執(zhí)行,規(guī)范就是一紙空文敬矩;
規(guī)范有哪些
規(guī)范有研發(fā)部門(mén)通用規(guī)范,比如會(huì)議紀(jì)要當(dāng)天寫(xiě)當(dāng)天發(fā),周報(bào)等;
部門(mén)規(guī)范,比如代碼gerrit提交規(guī)范,內(nèi)測(cè)發(fā)布規(guī)范薯蝎;
跨組規(guī)范: API文檔規(guī)范等等;
代碼提交規(guī)范
這里簡(jiǎn)單分享一下APP組的提交規(guī)范
總要求:多筆提交谤绳,養(yǎng)成好代碼提交習(xí)慣;
格式規(guī)范:
-
Bug修改類(lèi):
- (項(xiàng)目名稱(chēng))-FixBug:#編號(hào)-描述
-
業(yè)務(wù)開(kāi)發(fā)類(lèi):
- ADD:(項(xiàng)目名稱(chēng))-#(需求編號(hào))小的功能就提交袒哥,項(xiàng)目初始化缩筛;
- UPDATE:(項(xiàng)目名稱(chēng))-(修改優(yōu)化)描述
- DELETE:(項(xiàng)目名稱(chēng))-需求改動(dòng)導(dǎo)致刪掉或者注釋掉部分代碼;
- OTHER:(項(xiàng)目名稱(chēng))-(暫無(wú))
為什么要考慮加一個(gè)項(xiàng)目名稱(chēng)?
因?yàn)槊恳还P代碼提交都是你對(duì)公司的貢獻(xiàn),軟件不像硬件或者其他部門(mén),衡量軟件開(kāi)發(fā)的一個(gè)指標(biāo)就是代碼提交,可以不用很多,但是必須提交,并且每筆提交需要有對(duì)應(yīng)的簡(jiǎn)述,讓同伴知道你在做什么項(xiàng)目的什么功能;這很有必要;
為什么很有必要?
提交代碼一般不寫(xiě)提交說(shuō)明就提交上去了堡称,我相信很多人都干過(guò)這事瞎抛。比如這樣的
有些人說(shuō),要說(shuō)明好煩啊却紧,我就不想寫(xiě)桐臊,不就是把代碼f存在服務(wù)器嗎胎撤?然而,僅僅是這樣嗎断凶?
設(shè)想一下伤提,有一天,你發(fā)現(xiàn)你的代碼錯(cuò)了,你想把之前的那段代碼找回來(lái)认烁,可是肿男,當(dāng)我看著代碼提交歷史的時(shí)候,你根本不知道你要恢復(fù)到那一筆,是不是很恐怖的事,為了解決,你說(shuō),我重寫(xiě)一下,假如功能小還好說(shuō),如果是很大的功能呢,還有,你恢復(fù)一下,比你重寫(xiě)花費(fèi)的時(shí)間少多了,不是嗎?
還有你年終總結(jié)的時(shí)候,翻一番自己的提交歷史,就知道你完成了啥;
今年完成了什么項(xiàng)目?
修改了哪些bug;
哪些bug讓你印象深刻;
是不是規(guī)范這東西,挺有用;
規(guī)范,就是用來(lái)約束你的行為準(zhǔn)則,一旦公司有新成員進(jìn)入,看看規(guī)范,立馬就能融入到工作中,站在公司的角度,不會(huì)因?yàn)橐粋€(gè)人的得失,而使得項(xiàng)目推進(jìn)變得困難;
以上就是本次分享却嗡,謝謝觀(guān)看舶沛;