自拍偷在线精品自拍偷,亚洲欧美中文日韩v在线观看不卡

技術文章是怎樣煉成的

開發(fā) 前端
少說廢話,把主題句(關鍵句)給我們拿出來看就行了,甭寫一堆的廢話?!芏嗳吮緛硪痪湓捘芙忉屒宄氖虑?,用上百行字去讓人明白。這很大程度上也說明他自己也在迷糊中。

思維導圖

介紹

最近看到很多這方面的文章,我就想了想,我認為的好的技術文章是什么樣的?

這文章主要是寫給自己的,對我以后的技術文章有警醒作用。

目標群體

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

我所說的“目標群體”是大家,也包括你自己。你的文章是給大家讀的,也是給自己讀的。

大家能看你的文章,應該是我們的榮幸,我們應該高興?,F(xiàn)在的互聯(lián)網(wǎng)是個信息大爆炸的時代,什么文章沒有,能看你的文章,有人關注你,難道你不應該慶幸嗎

如果大家能在看你文章的時候,給你寫評論,那你更應該高興,因為人家確實看了你的文章。而且如果給你寫一些建議,那你更應該高興不已。因為你得到了意外收獲。

簡單、明了

你寫的文章,盡量應該簡單,明白。——寫技術文章,應該把復雜的弄簡單,而不是把簡單的弄復雜,畢竟不是寫書。

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

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

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

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

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

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

順序

你***把你最主要、最重要的東西往前排。——畢竟不會每個人都看完你的文章。大家都是忙人,還要干別的事呢?哪有心思看完你整片文章。

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

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

簡短

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

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

重構

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

我們寫完文章,要經(jīng)常性的翻看自己的文章??次恼碌倪^程,是我們再一次學習的過程。

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

配圖

盡量配置一些圖片,很多時候圖片很能說明問題。——如果能配置動畫視頻,那就更爽了。

很多時候圖能說明的問題,是文字無法比擬的。

準確

不要害怕自己的觀點錯誤,或者技術錯誤,大膽的寫,如果有人給你指正出來,那你就去找資料去核實下,然后再去改正,這中間你也能學到很多東西。

不要怕錯誤——勇者無敵嗎!

原文鏈接:http://www.cnblogs.com/baochuan/archive/2012/04/13/2445140.html

  1. 我跳槽是因為他們的顯示器更大
  2. 響應式網(wǎng)頁設計三步走
  3. 北上廣之外的IT技術人生
  4. 為什么說你不要獨自編程
  5. 看看牛人們是怎么評價編程語言的
責任編輯:張偉 來源: 川山甲的博客
相關推薦

2010-03-24 15:40:39

網(wǎng)管運維管理摩卡軟件

2011-11-25 09:48:04

天線無線

2013-08-19 16:17:48

CIO

2024-03-28 08:13:51

GPTsOpenAI人工智能

2015-11-10 09:09:23

代碼程序員成長

2015-09-06 09:09:13

2014-06-20 10:34:42

開源

2019-06-17 08:57:13

優(yōu)秀工程師技術程序員

2010-12-28 10:40:50

admin

2021-02-08 23:52:17

CISO安全主管首席信息安全官

2018-02-26 18:54:37

2015-08-27 15:06:42

全能渠道華為

2021-03-17 09:48:48

高質量技術文章

2012-08-29 09:58:34

JavaScriptJavaScript模

2021-06-29 08:45:55

邏輯變量法函數(shù)

2015-09-29 10:18:22

2009-02-23 13:05:32

程序員學習方法

2012-12-03 10:22:24

程序員

2010-01-25 17:06:49

ibmdw回顧2009

2021-04-08 09:42:17

程序員技能開發(fā)者
點贊
收藏

51CTO技術棧公眾號