正在看一本書，書上講到一個(gè)觀點(diǎn)，“可工作的軟件勝過面面俱到的文檔”，這一點(diǎn)我一直都很認(rèn)可，在平時(shí)工作中也是依據(jù)這一觀點(diǎn)不寫詳細(xì)設(shè)計(jì)文檔就開始編碼，設(shè)計(jì)過程只做比較粗略的概要設(shè)計(jì)，但是涉及到數(shù)據(jù)庫(kù)設(shè)計(jì)的話，會(huì)做好數(shù)據(jù)庫(kù)的詳細(xì)設(shè)計(jì)再做編碼。

可能是自己的技術(shù)能力還不夠，無法在編碼之前就將所有涉及到的問題都想明白，然后做出非常詳細(xì)的設(shè)計(jì)，我會(huì)急于寫代碼，讓軟件先有一個(gè)可運(yùn)行的原型，如果原型代碼寫得好，就不改動(dòng)，直接測(cè)試上線運(yùn)行，但是多數(shù)情況都會(huì)做一下重構(gòu)，增加一些注釋，規(guī)范一下命名，提取可重用的代碼，精簡(jiǎn)代碼，提升代碼質(zhì)量，優(yōu)化運(yùn)行性能等。以至于整個(gè)軟件做完上線后，我也沒有一個(gè)詳細(xì)的設(shè)計(jì)文檔，不夠我自認(rèn)為我寫文檔的能力不行，實(shí)在寫不出高質(zhì)量的文檔。

接手別人的半路項(xiàng)目，在了解功能后，我也會(huì)直接看代碼，文檔什么的看不出來什么結(jié)果，看了文檔也不知道bug在哪，怎么修改程序。

文檔也是重要的，至少需求文檔和概要設(shè)計(jì)以及操作手冊(cè)這幾個(gè)文檔是必須需要的，能夠有詳細(xì)設(shè)計(jì)文檔當(dāng)然也是很好的，只是說可工作的軟件才是最主要的最重要的。這個(gè)觀點(diǎn)不針對(duì)產(chǎn)品的銷售和技術(shù)支持，只針對(duì)研發(fā)以及維護(hù)人員。

轉(zhuǎn)載于:https://www.cnblogs.com/chouchoucoder/p/3518560.html

創(chuàng)作挑戰(zhàn)賽新人創(chuàng)作獎(jiǎng)勵(lì)來咯，堅(jiān)持創(chuàng)作打卡瓜分現(xiàn)金大獎(jiǎng)

總結(jié)

以上是生活随笔為你收集整理的可工作的软件胜过面面俱到的文档的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。