技術(shù)文檔工程師和程序員的關(guān)系，有點(diǎn)像記者和消息源——你得不斷去打擾對(duì)方，問(wèn)一些可能讓人不舒服的問(wèn)題。只是我們的目的不是寫新聞，而是把產(chǎn)品講清楚。

這些年我合作過(guò)的程序員不少，他們對(duì)文檔的態(tài)度千差萬(wàn)別。有人讓你如沐春風(fēng)，有人讓你懷疑人生。我大概歸納了5種典型類型，以下描述基于真實(shí)經(jīng)歷，性別用"他"只是方便敘述，實(shí)際上每種類型男女都有。

類型一：金毛尋回犬型

這是技術(shù)文檔工程師的最愛。如果他是條狗，絕對(duì)是金毛——溫順、配合、真心投入項(xiàng)目。你問(wèn)他問(wèn)題不用擔(dān)心被翻白眼，他會(huì)認(rèn)真看你的修改建議，積極參與討論，下次交稿明顯比上次好。我曾經(jīng)和同事?lián)屵^(guò)誰(shuí)負(fù)責(zé)對(duì)接這位"金毛男孩"的文檔，最后差點(diǎn)打起來(lái)。

最佳合作對(duì)象，沒(méi)有之一。

類型二："人人都會(huì)寫"型

他覺(jué)得寫文檔沒(méi)什么技術(shù)含量。"前置條件放文檔末尾？這是設(shè)計(jì)如此。""概念不清楚？我覺(jué)得夠清楚了。""再加細(xì)節(jié)？太長(zhǎng)了，現(xiàn)在就已經(jīng)夠長(zhǎng)了。"他總說(shuō)"我知道怎么寫，我自己來(lái)"，卻不明白技術(shù)文檔不只是把字碼上去，還要考慮信息結(jié)構(gòu)、簡(jiǎn)潔度和讀者需求。結(jié)果通常是：滿篇術(shù)語(yǔ)、解釋模糊、信息缺失、結(jié)構(gòu)混亂——用戶看得比報(bào)錯(cuò)還難受。

最打擊工作積極性的類型。

類型三："我什么都不知道"型

每家公司都有。你去找他詢問(wèn)他負(fù)責(zé)維護(hù)的項(xiàng)目，他一臉茫然："我不知道。"換種問(wèn)法，還是："我不知道。"你分不清他是真不懂，還是裝不懂好逃避寫文檔。還有個(gè)變種：其實(shí)不懂，但假裝懂，給出一個(gè)聽起來(lái)對(duì)、細(xì)想全錯(cuò)的答案。

（原文此處截?cái)啵刺峁┖罄m(xù)兩種類型的完整描述）