國內(nèi)互聯(lián)網(wǎng)從業(yè)者在寫文檔上是比較欠缺的玄叠，尤其是工程師，甚至抵觸寫文檔拓提。據(jù)我看來读恃，文檔還是很重要的，尤其是企業(yè)越來越壯大崎苗，系統(tǒng)越來越復(fù)雜狐粱，文檔的規(guī)范化和標(biāo)準(zhǔn)化就顯得更重要。
不過胆数，反過來說肌蜻，企業(yè)太過臃腫也不利于發(fā)展，英特爾公司的安迪◎格魯夫就曾為公司壯大后漸漸喪失初創(chuàng)時的高效和應(yīng)變能力而憂慮必尼。吳軍在「硅谷之謎」中介紹的“扁平式管理”是解決這個問題的一種方法蒋搜，它是介于兩者之間的一種管理機制。這超出了本文的范圍判莉，感興趣的朋友可以閱讀「硅谷之謎」豆挽。
回到主題，由于筆者是重度強迫癥患者券盅，就助養(yǎng)了「看到糟糕文檔就忍不住要罵人」的毛病帮哈。但也確實發(fā)現(xiàn)一些不好的現(xiàn)象和問題，比如锰镀，有時候負責(zé)需求的業(yè)務(wù)人員不了解需求或沒有深入的理解娘侍，需求文檔中甚至有歧義。而程序不能有二義性泳炉，等細化需求時憾筏，他一臉懵逼的表情，讓人很無奈花鹅，也很無語氧腰，很……
上面的問題，應(yīng)該跟國內(nèi)職位分的很細有關(guān)：從戰(zhàn)略規(guī)劃，到產(chǎn)品經(jīng)理古拴，需求分析師箩帚，產(chǎn)品設(shè)計師，用戶體驗設(shè)計師斤富，系統(tǒng)架構(gòu)師膏潮，到實施者——工程師锻狗。如果繼續(xù)細分满力，還能分更多，而層級越多轻纪，效率就越低油额，出錯也越多。這就需要每個角色在側(cè)重本職工作的同時對其他角色的工作有所了解刻帚，至少要知道如何銜接上下過渡部分潦嘶。如果不能做好這個“偏科”，勢必會導(dǎo)致系統(tǒng)在實施過程出現(xiàn)“斷層”漱贱，或“所得非所想”滋觉，結(jié)果是「城門失火嘱巾，殃及池魚」。
聽聞硅谷的工程師大多能夠從上到下锰蓬，掌控每一層環(huán)節(jié)，無所不通眯漩，所以他們的文化是工程師文化芹扭，那里的工程師是真正的主人。硅谷的互聯(lián)網(wǎng)公司的產(chǎn)品經(jīng)理很少赦抖，架構(gòu)師也很少舱卡，工程師“包辦”一切。也許這就是為什么國內(nèi)的程序員被稱為“碼農(nóng)”队萤，只會碼代碼轮锥，可不就是碼農(nóng)？
另外一個糟糕問題是要尔，業(yè)務(wù)人員常常把從客戶拿來的原始需求直接放進文檔舍杜，零零散散，懶得整理盈电，更別說梳理了蝴簇。為什么不整理，他們不愿意去做這個工作嗎匆帚？我覺得也未必熬词，我更愿意認(rèn)為是他們「不會」，他們?nèi)狈ψ銐虻男畔⑻幚砟芰Αo論在哪行哪業(yè)互拾，溝通和寫作都是很重要的基本工作能力歪今，是信息處理的基礎(chǔ)，尤其是互聯(lián)網(wǎng)行業(yè)颜矿。所以寄猩，寫作能力的重要性可想而知。
其實骑疆，平時胡亂寫些什么田篇，都可以鍛煉寫作能力，當(dāng)能夠把一件事情向別人描述清楚時箍铭，自己才算真正理解泊柬。在寫設(shè)計文檔時深有體會，接到需求時可能云里霧里诈火，但寫著寫著兽赁，思路就像泉涌一樣越來越清晰，開發(fā)實現(xiàn)也自然水到渠成冷守。
關(guān)于寫文檔刀崖，一位硅谷的女神曾說過：“好的技術(shù)文檔都不是寫出來的，而是一遍一遍改出來的拍摇×燎眨”
At 2017.02.15
