最近看到很多這方面的文章，我就想了想，我認(rèn)為的好的技術(shù)文章是什么樣的？

　　這文章主要是寫給自己的，對(duì)我以后的技術(shù)文章有警醒作用。

 

 

　　不是讓你在文章開頭寫下，你的文章適合什么樣的人讀？——這是什么意思，鄙視我看不懂你的文章。

 

　　我所說的“目標(biāo)群體”是大家，也包括你自己。你的文章是給大家讀的，也是給自己讀的。

 

　　大家能看你的文章，應(yīng)該是我們的榮幸，我們應(yīng)該高興。現(xiàn)在的互聯(lián)網(wǎng)是個(gè)信息大爆炸的時(shí)代，什么文章沒有，能看你的文章，有人關(guān)注你，難道你不應(yīng)該慶幸嗎？

　　如果大家能在看你文章的時(shí)候，給你寫評(píng)論，那你更應(yīng)該高興，因?yàn)槿思掖_實(shí)看了你的文章。而且如果給你寫一些建議，那你更應(yīng)該高興不已。因?yàn)槟愕玫搅艘馔馐斋@。

 

 

 

　　你寫的文章，盡量應(yīng)該簡單，明白。——寫技術(shù)文章，應(yīng)該把復(fù)雜的弄簡單，而不是把簡單的弄復(fù)雜，畢竟不是寫書。

　　

　　很多“牛人”，很會(huì)賣弄風(fēng)騷，把文章寫的跟舊社會(huì)女人的裹腳布一樣，又臭，又長。——有的時(shí)候我也經(jīng)常犯這樣的錯(cuò)誤，雖然我不是”牛人“。

 

　　那么怎樣寫的簡單、明了呢？

　　1、少說廢話，把主題句（關(guān)鍵句）給我們拿出來看就行了，甭寫一堆的廢話。——很多人本來一句話能解釋清楚的事情，用上百行字去讓人明白。這很大程度上也說明他自己也在迷糊中。

　　2、可以加一些解釋，最多用四句話。——如果超過四句話，說明你還在糊涂中，你就需要“重構(gòu)“了，把內(nèi)容盡量縮短。——畢竟你有時(shí)間看，但不要浪費(fèi)大家的時(shí)間。

　　3、用圖像把主題意思提煉出來。如果你的圖，能說明你的問題，那你就用圖表示，再加一些輔助的文字說明（這是大家不明白的時(shí)候才看的）

　　4、技術(shù)名詞給個(gè)連接。——很多人寫文章有個(gè)特點(diǎn)，當(dāng)提到某個(gè)技術(shù)的時(shí)候，先介紹這個(gè)技術(shù)是什么？這用你說嗎？現(xiàn)在的百科，wiki哪一個(gè)說的不比你清楚啊，你只需要給個(gè)連接就行了。

 

 

 

　　你最好把你最主要、最重要的東西往前排。——畢竟不會(huì)每個(gè)人都看完你的文章。大家都是忙人，還要干別的事呢？哪有心思看完你整片文章。

 

　　我記得我想看一些技術(shù)類的書籍的時(shí)候，剛開始很興致勃勃的去買了相關(guān)書籍，結(jié)果我看了前兩章，實(shí)在沒心思再往后看了，這種書我通常用半年或者一年的時(shí)間去看完。畢竟用我辛苦掙得錢買的，如果不看完，心里虧得晃。

 

　　但是我發(fā)現(xiàn)，很多開始提不起興趣的書，越到后面越讓我來了興致，越到后面越精彩，越到后面我的收獲就越大。——為什么學(xué)點(diǎn)有用的東西就那么難呢？

 

 

 

 

　　你的文章盡量要簡短。看長長的文章，跟看長函數(shù)一樣，讓人望而生畏。

 

　　如果你的文章很長才能說明問題，那我建議你，可以把文章做成系列，分幾個(gè)系列給大家看。每次回頭想看的時(shí)候，更有針對(duì)性。——這就跟我們寫代碼一樣，不要讓你的類太長，如果太長，那你該重構(gòu)了——Extract Class。

 

 

　　不要以為你能一下就能把你的文章寫好，你也不是完人，就算是再牛的作家，也還要不停的修改他的文章呢？何況你只是一個(gè)coder而已？

　　我們寫完文章，要經(jīng)常性的翻看自己的文章。看文章的過程，是我們再一次學(xué)習(xí)的過程。

　　翻看的時(shí)候，我們自己經(jīng)常能發(fā)現(xiàn)一些問題。如標(biāo)點(diǎn)符號(hào)、錯(cuò)別字、代碼錯(cuò)誤、語病、文章樣式...

 

 

　　盡量配置一些圖片，很多時(shí)候圖片很能說明問題。——如果能配置動(dòng)畫視頻，那就更爽了。

 

　　很多時(shí)候圖能說明的問題，是文字無法比擬的。

 

 

　　我知道，很多人看了我的文章有可能會(huì)吐血，會(huì)拍磚。那就猛拍吧？拍死我算了。