新聞中心
思維導(dǎo)圖

介紹
最近看到很多這方面的文章,我就想了想,我認(rèn)為的好的技術(shù)文章是什么樣的?
這文章主要是寫給自己的,對我以后的技術(shù)文章有警醒作用。
目標(biāo)群體
不是讓你在文章開頭寫下,你的文章適合什么樣的人讀?——這是什么意思,鄙視我看不懂你的文章。
我所說的“目標(biāo)群體”是大家,也包括你自己。你的文章是給大家讀的,也是給自己讀的。
大家能看你的文章,應(yīng)該是我們的榮幸,我們應(yīng)該高興?,F(xiàn)在的互聯(lián)網(wǎng)是個信息大爆炸的時代,什么文章沒有,能看你的文章,有人關(guān)注你,難道你不應(yīng)該慶幸嗎
如果大家能在看你文章的時候,給你寫評論,那你更應(yīng)該高興,因為人家確實看了你的文章。而且如果給你寫一些建議,那你更應(yīng)該高興不已。因為你得到了意外收獲。
簡單、明了
你寫的文章,盡量應(yīng)該簡單,明白?!獙懠夹g(shù)文章,應(yīng)該把復(fù)雜的弄簡單,而不是把簡單的弄復(fù)雜,畢竟不是寫書。
很多“牛人”,很會賣弄風(fēng)騷,把文章寫的跟舊社會女人的裹腳布一樣,又臭,又長?!械臅r候我也經(jīng)常犯這樣的錯誤,雖然我不是”牛人“。
那么怎樣寫的簡單、明了呢?
1、少說廢話,把主題句(關(guān)鍵句)給我們拿出來看就行了,甭寫一堆的廢話?!芏嗳吮緛硪痪湓捘芙忉屒宄氖虑椋蒙习傩凶秩プ屓嗣靼?。這很大程度上也說明他自己也在迷糊中。
2、可以加一些解釋,最多用四句話?!绻^四句話,說明你還在糊涂中,你就需要“重構(gòu)“了,把內(nèi)容盡量縮短?!吘鼓阌袝r間看,但不要浪費大家的時間。
3、用圖像把主題意思提煉出來。如果你的圖,能說明你的問題,那你就用圖表示,再加一些輔助的文字說明(這是大家不明白的時候才看的)
4、技術(shù)名詞給個連接?!芏嗳藢懳恼掠袀€特點,當(dāng)提到某個技術(shù)的時候,先介紹這個技術(shù)是什么?這用你說嗎?現(xiàn)在的百科,wiki哪一個說的不比你清楚啊,你只需要給個連接就行了。
順序
你***把你最主要、最重要的東西往前排。——畢竟不會每個人都看完你的文章。大家都是忙人,還要干別的事呢?哪有心思看完你整片文章。
我記得我想看一些技術(shù)類的書籍的時候,剛開始很興致勃勃的去買了相關(guān)書籍,結(jié)果我看了前兩章,實在沒心思再往后看了,這種書我通常用半年或者一年的時間去看完。畢竟用我辛苦掙得錢買的,如果不看完,心里虧得晃。
但是我發(fā)現(xiàn),很多開始提不起興趣的書,越到后面越讓我來了興致,越到后面越精彩,越到后面我的收獲就越大?!獮槭裁磳W(xué)點有用的東西就那么難呢?
簡短
你的文章盡量要簡短??撮L長的文章,跟看長函數(shù)一樣,讓人望而生畏。
如果你的文章很長才能說明問題,那我建議你,可以把文章做成系列,分幾個系列給大家看。每次回頭想看的時候,更有針對性。——這就跟我們寫代碼一樣,不要讓你的類太長,如果太長,那你該重構(gòu)了——Extract Class。
重構(gòu)
不要以為你能一下就能把你的文章寫好,你也不是完人,就算是再牛的作家,也還要不停的修改他的文章呢?何況你只是一個coder而已?
我們寫完文章,要經(jīng)常性的翻看自己的文章??次恼碌倪^程,是我們再一次學(xué)習(xí)的過程。
翻看的時候,我們自己經(jīng)常能發(fā)現(xiàn)一些問題。如標(biāo)點符號、錯別字、代碼錯誤、語病、文章樣式...
配圖
盡量配置一些圖片,很多時候圖片很能說明問題?!绻芘渲脛赢嬕曨l,那就更爽了。
很多時候圖能說明的問題,是文字無法比擬的。
準(zhǔn)確
不要害怕自己的觀點錯誤,或者技術(shù)錯誤,大膽的寫,如果有人給你指正出來,那你就去找資料去核實下,然后再去改正,這中間你也能學(xué)到很多東西。
不要怕錯誤——勇者無敵嗎!
新聞標(biāo)題:技術(shù)文章是怎樣煉成的
分享鏈接:http://www.5511xx.com/article/dhiooic.html


咨詢
建站咨詢
