文檔對(duì)軟件開(kāi)發(fā)項(xiàng)目實(shí)施起到什么作用？
一般來(lái)說(shuō)，軟件開(kāi)發(fā)文檔是否規(guī)范和專(zhuān)業(yè)已成為軟件開(kāi)發(fā)的重要評(píng)價(jià)指標(biāo)之一。經(jīng)由深入分析，我總結(jié)這個(gè)項(xiàng)目主要存在這些缺陷：①文檔編寫(xiě)不夠規(guī)范：主要表現(xiàn)為軟件開(kāi)發(fā)項(xiàng)目實(shí)施過(guò)程中，沒(méi)有對(duì)每一個(gè)階段的文檔進(jìn)行分層次收拾整頓和治理，各類(lèi)文檔資料缺少一致性。②文檔內(nèi)容描寫(xiě)不夠完善：在編寫(xiě)各種文檔過(guò)程中，固然大家都按事先劃定的模式進(jìn)行了編寫(xiě)，但編寫(xiě)的內(nèi)容常常不夠完善；要么文檔極其簡(jiǎn)樸，相稱(chēng)于沒(méi)有文檔；要么文檔流于形式，沒(méi)有什么實(shí)際的價(jià)值，甚至于有的軟件開(kāi)發(fā)文檔與實(shí)施過(guò)程完全不相符。③文檔沒(méi)有同一入庫(kù)治理：跟著軟件開(kāi)發(fā)系統(tǒng)的不斷優(yōu)化、進(jìn)級(jí)，新需求的不斷產(chǎn)生，各種文檔越來(lái)越多，沒(méi)有建立一個(gè)文檔資料庫(kù)。不同時(shí)期的各種文檔零散存在，造成查詢(xún)文檔時(shí)非常難題。④只正視文檔的形式，實(shí)用性不強(qiáng)。在實(shí)際的實(shí)施過(guò)程中，編制職員沒(méi)有時(shí)間去關(guān)心它們的用途，也不知道哪些部分使用，更多的是在劃定的時(shí)間內(nèi)完成任務(wù)，以免影響考核成績(jī)，這樣一來(lái)一些不實(shí)用的、重復(fù)的文檔不但阻礙軟件開(kāi)發(fā)的可執(zhí)行性，而且還影響項(xiàng)目的整體進(jìn)度。
常見(jiàn)的軟件開(kāi)發(fā)文檔缺陷
從內(nèi)容上說(shuō)，軟件開(kāi)發(fā)項(xiàng)目軟件開(kāi)發(fā)文檔可分為成果文檔和過(guò)程文檔兩大類(lèi)。成果文檔作為項(xiàng)目可交付物的一個(gè)組成部門(mén)，其重要性天然不問(wèn)可知。過(guò)程文檔主要記實(shí)了項(xiàng)目治理進(jìn)程中的各種信息，為實(shí)施職員提供決議計(jì)劃依據(jù)，以保證軟件開(kāi)發(fā)項(xiàng)目的順利實(shí)現(xiàn)；另一方面，過(guò)程文檔也是實(shí)施過(guò)程最為寶貴的資產(chǎn)，通過(guò)對(duì)過(guò)程文檔進(jìn)行歸納和分析，可以對(duì)實(shí)施項(xiàng)目的成功經(jīng)驗(yàn)和失敗教訓(xùn)了然于胸，從而對(duì)后續(xù)軟件開(kāi)發(fā)日常運(yùn)作、維護(hù)更加有的放矢。
軟件開(kāi)發(fā)文檔是用來(lái)記實(shí)、描述、展示實(shí)施過(guò)程一系列信息的處理過(guò)程，通過(guò)書(shū)面或圖示的形式對(duì)項(xiàng)目流動(dòng)過(guò)程或結(jié)果進(jìn)行描述、定義、劃定及講演。例如，分階段實(shí)施計(jì)劃文檔、尺度業(yè)務(wù)流程文檔、尺度編碼及數(shù)據(jù)文檔、尺度參數(shù)設(shè)置文檔、功能操縱指南文檔等。這些文檔將會(huì)伴跟著軟件開(kāi)發(fā)的各個(gè)階段逐漸充實(shí)、完善,也同時(shí)記載了整個(gè)實(shí)施的過(guò)程和成果。
什么是軟件開(kāi)發(fā)文檔？
當(dāng)我從公司前任軟件開(kāi)發(fā)項(xiàng)目實(shí)施同事手中接過(guò)"薄薄兩頁(yè)紙"的軟件開(kāi)發(fā)文檔時(shí)，我難以置信的看著他問(wèn)"沒(méi)有了嗎？只有這些？"，我同事尷尬的點(diǎn)點(diǎn)頭，然后他再說(shuō)了一句讓我吐血的話"實(shí)施計(jì)劃和記實(shí)文檔都在我心里記記清清晰楚呢。"實(shí)際上，這完全是對(duì)軟件開(kāi)發(fā)文檔的曲解，也是很多軟件開(kāi)發(fā)參謀的通病。
陽(yáng)春三月, 本應(yīng)是陽(yáng)光明媚令人心曠神怡的季節(jié),但正如近日倒春寒的天色一樣讓我感到深深的寒意。原因是最近公司讓我接手一個(gè)實(shí)施到一半的軟件開(kāi)發(fā)項(xiàng)目，而這個(gè)項(xiàng)目只有片言片語(yǔ)的幾份簡(jiǎn)樸文檔。不但沒(méi)有具體的實(shí)施計(jì)劃，更沒(méi)有具體的軟件開(kāi)發(fā)文檔記實(shí)。在接手此項(xiàng)目后讓我深深的感慨感染到?jīng)]有軟件開(kāi)發(fā)文檔的痛苦，由于所有的一切都要自己重新試探。不但鋪張了寶貴的實(shí)施時(shí)間，而且還常常需要做重復(fù)的工作。缺乏軟件開(kāi)發(fā)文檔讓我在這個(gè)軟件開(kāi)發(fā)項(xiàng)目中吃盡了苦頭，這里和大家分享我對(duì)軟件開(kāi)發(fā)文檔的一些反思和總結(jié)。
選購(gòu)指南：
本公司主要為山東地區(qū)的商業(yè)、企業(yè)及個(gè)人提供各類(lèi)定制開(kāi)發(fā)服務(wù)，如：軟件定制開(kāi)發(fā)、APP定制開(kāi)發(fā)、微信定制開(kāi)發(fā)以及P5業(yè)務(wù)支撐平臺(tái)等整體的信息化解決方案，能夠滿足各類(lèi)大中小型商業(yè)、企業(yè)及個(gè)人的需要。
