国产av一二三区|日本不卡动作网站|黄色天天久久影片|99草成人免费在线视频|AV三级片成人电影在线|成年人aV不卡免费播放|日韩无码成人一级片视频|人人看人人玩开心色AV|人妻系列在线观看|亚洲av无码一区二区三区在线播放

網(wǎng)易首頁 > 網(wǎng)易號 > 正文 申請入駐

技術(shù)文檔工程師眼中的5類程序員

0
分享至

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

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


類型一:金毛尋回犬型

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

最佳合作對象,沒有之一。

類型二:"人人都會寫"型

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

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

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

每家公司都有。你去找他詢問他負(fù)責(zé)維護(hù)的項目,他一臉茫然:"我不知道。"換種問法,還是:"我不知道。"你分不清他是真不懂,還是裝不懂好逃避寫文檔。還有個變種:其實不懂,但假裝懂,給出一個聽起來對、細(xì)想全錯的答案。

(原文此處截斷,未提供后續(xù)兩種類型的完整描述)

特別聲明:以上內(nèi)容(如有圖片或視頻亦包括在內(nèi))為自媒體平臺“網(wǎng)易號”用戶上傳并發(fā)布,本平臺僅提供信息存儲服務(wù)。

Notice: The content above (including the pictures and videos if any) is uploaded and posted by a user of NetEase Hao, which is a social media platform and only provides information storage services.

相關(guān)推薦
熱點(diǎn)推薦
馬斯克:每年休息兩三天,試過睡不到6小時結(jié)果腦子很痛效率很低

馬斯克:每年休息兩三天,試過睡不到6小時結(jié)果腦子很痛效率很低

頂級大佬思維
2026-05-09 14:23:20
電動車電池終于要變了:半固態(tài)電池真的來了

電動車電池終于要變了:半固態(tài)電池真的來了

像素與芯片
2026-05-08 23:31:19
駐加爾各答總領(lǐng)館再次提醒中國公民避免自尼泊爾誤入印度國境

駐加爾各答總領(lǐng)館再次提醒中國公民避免自尼泊爾誤入印度國境

環(huán)球網(wǎng)資訊
2026-05-09 21:42:17
大快人心!中國民航新規(guī)出爐:日本航空過境中國好日子即將到頭!

大快人心!中國民航新規(guī)出爐:日本航空過境中國好日子即將到頭!

影像溫度
2026-05-09 10:27:26
“4只皮皮蝦1035元”當(dāng)事人否認(rèn)想吃白食,刪除評論;隔壁海鮮店發(fā)聲

“4只皮皮蝦1035元”當(dāng)事人否認(rèn)想吃白食,刪除評論;隔壁海鮮店發(fā)聲

上觀新聞
2026-05-09 09:58:08
求救也晚了,伊朗宣布對美艦開火,話音剛落,土耳其擺出洲際導(dǎo)彈

求救也晚了,伊朗宣布對美艦開火,話音剛落,土耳其擺出洲際導(dǎo)彈

潮鹿逐夢
2026-05-09 18:49:49
曝穆帥90%將回歸皇馬!43歲少帥當(dāng)眾落淚:為什么我就不能犯錯?

曝穆帥90%將回歸皇馬!43歲少帥當(dāng)眾落淚:為什么我就不能犯錯?

風(fēng)過鄉(xiāng)
2026-05-09 22:01:12
“尋天”商標(biāo)注冊!小米欲成立汽車獨(dú)立子品牌?官方未作回應(yīng)

“尋天”商標(biāo)注冊!小米欲成立汽車獨(dú)立子品牌?官方未作回應(yīng)

每日經(jīng)濟(jì)新聞
2026-05-09 19:47:07
國防部:已成功配齊“航母五件套”

國防部:已成功配齊“航母五件套”

大象新聞
2026-05-09 16:46:07
尷尬!網(wǎng)紅神褲成審美災(zāi)難,網(wǎng)友稱市場有需求,有些人恨不得裸奔

尷尬!網(wǎng)紅神褲成審美災(zāi)難,網(wǎng)友稱市場有需求,有些人恨不得裸奔

火山詩話
2026-05-09 19:50:52
特斯拉車主苦等多年,這個HUD終于把導(dǎo)航放回眼前

特斯拉車主苦等多年,這個HUD終于把導(dǎo)航放回眼前

閃存獵手
2026-05-09 01:01:43
因惡意退貨太多,整條街道被商家“拉黑”!網(wǎng)友:還是低估了羊毛黨...

因惡意退貨太多,整條街道被商家“拉黑”!網(wǎng)友:還是低估了羊毛黨...

品牌新
2026-05-09 09:25:01
新規(guī)落地!手機(jī)不用再交月租,聯(lián)通率先實行,移動電信全都跟上

新規(guī)落地!手機(jī)不用再交月租,聯(lián)通率先實行,移動電信全都跟上

笑熬漿糊111
2026-05-09 04:47:09
U17國足亞洲杯首球誕生!趙松源單刀破門,戲耍日本隊防線

U17國足亞洲杯首球誕生!趙松源單刀破門,戲耍日本隊防線

奧拜爾
2026-05-10 01:13:19
黃瓜立大功?醫(yī)生發(fā)現(xiàn):經(jīng)常吃黃瓜的人,不出半年,或有4大改善

黃瓜立大功?醫(yī)生發(fā)現(xiàn):經(jīng)常吃黃瓜的人,不出半年,或有4大改善

芹姐說生活
2026-05-09 21:08:03
外賣小哥冒死沖進(jìn)火場救火 被物業(yè)收取50元“滅火器使用費(fèi)”

外賣小哥冒死沖進(jìn)火場救火 被物業(yè)收取50元“滅火器使用費(fèi)”

閃電新聞
2026-05-09 09:31:06
南寧一群眾到法院申請立案被法警群毆斷兩根肋骨!警方:不予立案

南寧一群眾到法院申請立案被法警群毆斷兩根肋骨!警方:不予立案

兵叔評說
2026-05-09 13:21:06
臺積電的美國亞利桑那廠已悄然失敗,400億美元燒完,良率不到日本廠一半

臺積電的美國亞利桑那廠已悄然失敗,400億美元燒完,良率不到日本廠一半

風(fēng)向觀察
2026-05-09 13:29:53
美國突曝海量UFO文件!中國三大經(jīng)典UFO事件:蕭山機(jī)場真相顛覆!

美國突曝海量UFO文件!中國三大經(jīng)典UFO事件:蕭山機(jī)場真相顛覆!

大稻網(wǎng)絡(luò)科技
2026-05-09 09:29:34
上??駝?-0山東進(jìn)四強(qiáng):洛夫頓20+9+5 陳林堅21分王哲林14+6

上海狂勝2-0山東進(jìn)四強(qiáng):洛夫頓20+9+5 陳林堅21分王哲林14+6

醉臥浮生
2026-05-09 21:32:05
2026-05-10 03:03:00
野生運(yùn)營
野生運(yùn)營
懂點(diǎn)產(chǎn)品,懂點(diǎn)AI,正在努力給平淡日子搞點(diǎn)新花樣。
2417文章數(shù) 33關(guān)注度
往期回顧 全部

頭條要聞

演員文章面館大火后又開酒吧 多位明星到場母親也現(xiàn)身

頭條要聞

演員文章面館大火后又開酒吧 多位明星到場母親也現(xiàn)身

體育要聞

成立128年后,這支升班馬首奪頂級聯(lián)賽冠軍

娛樂要聞

50歲趙薇臉頰凹陷滄桑得認(rèn)不出!

財經(jīng)要聞

多地號召,公職人員帶頭繳納物業(yè)費(fèi)

科技要聞

美國政府強(qiáng)力下場 蘋果英特爾達(dá)成代工協(xié)議

汽車要聞

軸距加長/智駕拉滿 阿維塔07L定位大五座SUV

態(tài)度原創(chuàng)

時尚
藝術(shù)
親子
本地
軍事航空

伊姐周六熱推:電視劇《喀什戀歌》;電視劇《低智商犯罪》......

藝術(shù)要聞

深圳終究失去“中國第一高樓”,華潤接手地塊!

親子要聞

媽媽說女兒休學(xué)一年,我教她3個笨辦法

本地新聞

用蘇繡的方式,打開江西婺源

軍事要聞

美伊突然再次交火 伊朗外長:戰(zhàn)爭準(zhǔn)備程度是1000%

無障礙瀏覽 進(jìn)入關(guān)懷版