寫程序，做產(chǎn)品，過日子

看上去你是個新上來的領(lǐng)導(dǎo)吧，不是我批評你，“完全一致、具體到類和公用方法”的要求十分的蠻橫和武斷，證明你沒有真正理解項(xiàng)目組織的實(shí)質(zhì)，沒有理解文檔是做什么的，應(yīng)當(dāng)在項(xiàng)目中承擔(dān)什么樣的作用。
你被抵制是情理中的，一方面你這樣的要求過于理想化很難真正達(dá)到目標(biāo)，另一方面也是揚(yáng)短逼長，對人力物力資源的浪費(fèi)，文檔的維護(hù)性和表達(dá)能力遠(yuǎn)不如代碼，代碼里一個通用約定，幾十個字母能說清楚的問題用文字去表述要寫多少字（還不考慮有些程序員對寫文檔有天生的厭惡）？就算你說的要從面向未來的角度，那你將來要同步文檔和代碼，又需要多少的投入, 有多少實(shí)際的可能？算了，這個問題也不多說了，等你多碰幾次壁，自然就領(lǐng)會了。

  回復(fù)  更多評論
  

不敢茍同Weidy的意見，看了一下你的blog，比較推崇XP。我也很向往XP。可惜的是我的的產(chǎn)品規(guī)范是RUP。條條大路通羅馬，XP雖好，卻不一定適合每一個人。
的確有很多程序員喜歡寫代碼，討厭寫文檔。但如果是一名高級開發(fā)員，他的主要職責(zé)就是分析和設(shè)計(jì)。一個設(shè)計(jì)者如果不能把文檔寫好，怎么能成其為設(shè)計(jì)者？我們公司有一個目標(biāo)就是，高級開發(fā)員不寫代碼，只寫文檔。
關(guān)于文檔的維護(hù)性和表達(dá)能力遠(yuǎn)不如代碼這一點(diǎn)也值得商討。代碼是純文字，文檔的主要內(nèi)容是圖表，哪個更清楚顯而易見。
Weidy提到文檔將來要同步文檔和代碼的投入問題，這個投入對于一個項(xiàng)目來說的確不堪承擔(dān)，但對于一個產(chǎn)品來說，必做不可。
這一次根據(jù)安排，我們要投入15個人天來做這個事情。

  回復(fù)  更多評論
  

對 “文檔” 這兩個字可能有不同的理解。
我個人傾向于“代碼注釋(javadoc)+UML圖表+清晰的架構(gòu)說明圖表”。
Word文檔是商務(wù)人員使用的表達(dá)方式，承擔(dān)不起程序世界的思想交流。

解決問題的方法之一是統(tǒng)籌規(guī)范，化繁為簡。
如果你的項(xiàng)目依賴于過多的細(xì)節(jié)實(shí)現(xiàn)，可能是個不太優(yōu)美的系統(tǒng)，你不得不關(guān)注細(xì)節(jié)的方法實(shí)現(xiàn)。

當(dāng)然，如果是要參加競標(biāo)，提高系統(tǒng)價(jià)值，另當(dāng)別論。  回復(fù)  更多評論
  

同感, JavaDoc 和基礎(chǔ)的流程, 數(shù)據(jù)庫文檔, 必須得有. 至少 JavaDoc 是可以同步產(chǎn)生的, 隨時更新的. 看看 JDK 的 JavaDoc(當(dāng)然實(shí)際開發(fā)不用這么細(xì)) 就明白為啥 JDK 的編碼規(guī)范被人推崇.  回復(fù)  更多評論