Android开发项目管理7宗罪之五——项目组个性文档文件的管理
你這里提到的文檔,主要包括:接口開發(fā)文檔、技術(shù)框架說明文檔、新框架踩坑文檔、第三方SDK開發(fā)說明文檔、工作交接文檔等等。
接口開發(fā)文檔,這個好理解,基本上稍大點(diǎn)的項(xiàng)目,后臺開發(fā)都會提供,但大多數(shù)項(xiàng)目管理,都存在一個通病,那就是原始文檔能夠提供,但正確率不敢保證;后續(xù)開發(fā)、維護(hù)、增刪引發(fā)的內(nèi)容變動并不會及時的更新到接口文檔中去,很不方便項(xiàng)目的維護(hù)。所以接口文檔要及時更新。內(nèi)容應(yīng)該是要細(xì)化到每個入?yún)?#xff0c;每個返回字段的作用內(nèi)容說明,數(shù)據(jù)格式等等。
另外,開發(fā)中我發(fā)現(xiàn),后很多接口,即便是某個入口參數(shù)傳錯了,也能夠成功的拿到數(shù)據(jù)。這給后面的調(diào)試和排查問題帶來很大的干擾,后開和前端、移動端都不知道有沒有出錯,錯在哪里。這種情況應(yīng)該杜絕,參數(shù)錯了就訪問-失敗,沒什么好說的,很快就能夠定位到問題在哪里,是誰的問題。
/
第三方SDK開發(fā)文檔,主要是項(xiàng)目中采用第三方公司提供的服務(wù)SDK時的文檔,他能夠指導(dǎo)開發(fā)人員完成開發(fā)工作,當(dāng)對應(yīng)部分功能出現(xiàn)問題時,能夠從中找到解決方案,因此這種文檔也頗為重要,不容有失,越詳細(xì)越好。
工作交接文檔,這個很好理解,想必也是大家最頭疼的文檔,因?yàn)槭赜芯呕匕肽玫降倪@個文檔都是死然并卯的,毛用沒得還落人口實(shí),看,我離開時是留有很詳細(xì)的交接文檔的。有問題怪我咯?心里總是萬馬奔騰,而且還是滿身草的那種。。。扯遠(yuǎn)了。該文檔應(yīng)該包含如下內(nèi)容:該員工負(fù)責(zé)了那些功能模塊,目前這些功能模塊的開發(fā)進(jìn)度,各模塊的功能說明,各模塊所在的分包packge,各功能模塊的入口,完成情況,是否有遺留的問題,重點(diǎn)注意事項(xiàng)等等。
這份文檔相當(dāng)重要,它能有效的幫助接替者快速且全方位的掌握對應(yīng)功能模塊的現(xiàn)狀,了解現(xiàn)狀的實(shí)際情況,掌握重點(diǎn)難點(diǎn),不需要花費(fèi)太多的時間和精力去完全踩一遍項(xiàng)目的坑就能上手高效地開展工作。這里以上一篇《Android開發(fā)項(xiàng)目管理7宗罪之四——開發(fā)任務(wù)的分派》的內(nèi)容為例,前任開發(fā)中離崗時,對所負(fù)責(zé)的功能模塊完成情況只字不提,存在的問題只字不提,重點(diǎn)難點(diǎn)只字不提,只是 大概說了下各子功能所在的包,筆者無奈之下接手后,不得不從頭到尾的reView一遍他的代碼,理解開發(fā)思路,同時結(jié)合流程圖,接口文檔,需求文檔確定功能模塊的現(xiàn)狀,最后驚訝的發(fā)現(xiàn),其實(shí)該功能只是完成了總工作量的30%。后面花了接近3周的時間才完善該功能,單單是掌握該功能模塊的現(xiàn)狀,梳理邏輯就花了一周。最后感嘆,將近3周,還不如我自己從 0 開始開發(fā)來得好,這樣雖然工作量多了些,但不必如此勞心勞神勞力。
最后我們說說新技術(shù)/新框架的踩坑文檔。
踩坑文檔:主要是記錄在使用新技術(shù)/新框架過程中遇到的各種問題以及解決這些問題所經(jīng)歷的慘烈過程所形成的的文案。
以筆者曾經(jīng)所在的一個項(xiàng)目為例,該項(xiàng)目為了節(jié)約開發(fā)時間和成本,快速集成項(xiàng)目,采用了螞蟻金服出品的mpass框架,該框架被用于名聲極響的支付寶等項(xiàng)目上。但不是開源框架,若要使用,是需要螞蟻金服收費(fèi)授權(quán)的,所以市場上鮮有相關(guān)資料介紹,對其很是陌生。這不,在該項(xiàng)目集成mpass框架初期,遇到了各種各樣的坑,以至于團(tuán)隊(duì)不相信螞蟻金服的官方文檔的真實(shí)性。而螞蟻金服派出來的售后服務(wù)伙伴能夠提供的幫助比較有限,往往不能有效的解決問題。若要螞蟻方面派出高級專家支援的話,對方人員的一切開銷級補(bǔ)貼都需要項(xiàng)目組一力承擔(dān),成本壓力巨大。而不得不咬著牙關(guān)參考著官方文檔自己研究,直接導(dǎo)致了 不少員工不得不開啟9-10-6/7的工作模式而項(xiàng)目組規(guī)定21:00之后打出租車報銷費(fèi)用,這樣一算下來,項(xiàng)目組近20號人打車費(fèi)用都高的嚇人了。
經(jīng)過數(shù)月的攻堅,框架集成成功,前端開發(fā)也成功集成進(jìn)來,項(xiàng)目能夠得以推進(jìn)。但很遺憾的是數(shù)月的攻堅工作并沒有留下任何一篇有關(guān)踩坑mpass框架集成的文檔,開發(fā)者離崗后,后續(xù)接手的人對mpass礦機(jī)一無所知,一臉懵逼,工作無法盡快開展。這時不得不向項(xiàng)目負(fù)責(zé)人咨詢,但項(xiàng)目負(fù)責(zé)人更喜歡的是這時候你能夠加班加點(diǎn)的看代碼,看官方文檔研究出問題來。這時候,我真想說——研究NMDNGB,加個CZ的班,加班你這也叫項(xiàng)目管理,球技術(shù)文檔都沒留下一個,你這不是逼人再去踩一次前面的坑么?你就這么管理的啊?算了,得過且過,將就用著吧!!!……
所以,一定要記住,重要的新技術(shù)/新框架的技術(shù)文檔、踩坑文檔一定要寫好,越詳細(xì)越好,越有利于后面工作的開展,省時省力省成本……尤其是作為項(xiàng)目的直接管理者,一定要大力推動這件事情,一旦項(xiàng)目團(tuán)隊(duì)出現(xiàn)成員變動,這些資料就將大顯神威!!!
總結(jié)
以上是生活随笔為你收集整理的Android开发项目管理7宗罪之五——项目组个性文档文件的管理的全部內(nèi)容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: Python利用 Anaconda安装p
- 下一篇: 拥有百万粉丝的大牛讲述学Android的