很多軟件開(kāi)發(fā)人員覺(jué)得寫(xiě)軟件開(kāi)發(fā)文檔煩鎖且降低工作效率,我認(rèn)為主要是先已編碼開(kāi)發(fā)后補(bǔ)軟件開(kāi)發(fā)文檔,軟件開(kāi)發(fā)文檔并沒(méi)有對(duì)系統(tǒng)開(kāi)發(fā)起到實(shí)際的作用產(chǎn)生的。對(duì)于能給開(kāi)發(fā)起到實(shí)際作用系統(tǒng)設(shè)計(jì)、分析軟件開(kāi)發(fā)文檔誰(shuí)都不會(huì)認(rèn)為是多余的。軟件開(kāi)發(fā)文檔應(yīng)該適合軟件開(kāi)發(fā)過(guò)程相匹配一種表現(xiàn)形式，管理和技術(shù)是一個(gè)層面的，軟件開(kāi)發(fā)文檔和開(kāi)發(fā)過(guò)程是第二個(gè)層面上的。
1、軟件開(kāi)發(fā)文檔是記錄軟件開(kāi)發(fā)過(guò)程的一種重要手段，她是基于軟件開(kāi)發(fā)過(guò)程的一個(gè)非常重要而且是必不可少的表現(xiàn)形式；
2、軟件開(kāi)發(fā)文檔與軟件開(kāi)發(fā)過(guò)程的關(guān)系就像項(xiàng)目中管理與技術(shù)的關(guān)系是十分類似的：
以前有人爭(zhēng)論過(guò)管理和技術(shù)哪個(gè)更重要的問(wèn)題，在我看來(lái)：過(guò)于注重技術(shù)會(huì)造成開(kāi)發(fā)過(guò)程的人為因素過(guò)重，失去了有效的項(xiàng)目可控性。而管理過(guò)重的時(shí)候，會(huì)造成技術(shù)人員很強(qiáng)的失落感，影響開(kāi)發(fā)人員的士氣，乃至于項(xiàng)目延期，無(wú)人愿意承擔(dān)責(zé)任。
而軟件開(kāi)發(fā)文檔和軟件開(kāi)發(fā)過(guò)程也有類似的關(guān)系，過(guò)于注重軟件開(kāi)發(fā)文檔，形式化太強(qiáng)，會(huì)造成大量的時(shí)間浪費(fèi)，最終項(xiàng)目延期和經(jīng)費(fèi)的利用率降低等結(jié)果。而只注重過(guò)程忽視軟件開(kāi)發(fā)文檔，則會(huì)造成項(xiàng)目失去了可控性，因?yàn)闆](méi)有可以用于追蹤的有效記錄，也就無(wú)法檢查項(xiàng)目的進(jìn)展?fàn)顩r，造成項(xiàng)目的失敗。
3、軟件開(kāi)發(fā)文檔應(yīng)該注重實(shí)用，根據(jù)不同軟件開(kāi)發(fā)文檔的用戶來(lái)制定軟件開(kāi)發(fā)文檔的內(nèi)容，同時(shí)根據(jù)項(xiàng)目的不同調(diào)整軟件開(kāi)發(fā)文檔的結(jié)構(gòu)、數(shù)量、種類以及側(cè)重面。
對(duì)于軟件開(kāi)發(fā)的軟件開(kāi)發(fā)文檔，我認(rèn)為非常重要，軟件開(kāi)發(fā)文檔也是產(chǎn)品的一部分，是一定要寫(xiě)好的。一兩次口頭交流可能比軟件開(kāi)發(fā)文檔的成本要低，但幾十次、上百次呢，何況口頭交流是不精確的，不完整的?；ㄒ稽c(diǎn)時(shí)間來(lái)編寫(xiě)軟件開(kāi)發(fā)文檔，我認(rèn)為是完全必要的工作。而且軟件開(kāi)發(fā)文檔的編寫(xiě)應(yīng)該盡量完整和詳細(xì)，對(duì)此應(yīng)該開(kāi)發(fā)良好的軟件開(kāi)發(fā)文檔模板，供編寫(xiě)人員填寫(xiě)。
軟件開(kāi)發(fā)文檔當(dāng)然要注意實(shí)用，很多開(kāi)發(fā)人員對(duì)編寫(xiě)軟件開(kāi)發(fā)文檔感到厭惡，難寫(xiě)，我覺(jué)得很大的原因是他們并沒(méi)有對(duì)軟件開(kāi)發(fā)進(jìn)行充分的考慮，很多軟件開(kāi)發(fā)文檔里面要求寫(xiě)的東西他們從來(lái)就沒(méi)想過(guò)，只有瞎編一通，當(dāng)然心里會(huì)厭惡。
