如何寫技術博客

關於如何寫技術博客網絡上有着無數個版本,每一個人都有本身的看法,想寫一篇這樣的文章已經好久了,可是一直不知道如何出手。之因此不知道該如何落筆,一方面是由於我知道這樣的文章很容易引發口水戰,這是我最討厭的事情,另外一方面是讓人感受本身好爲人師,雖然本身對技術也有一些積累和心得,可是因爲本身就是一個討厭別人告訴本身該幹什麼幹什麼的人,己之不欲,勿施於人,因此一直遲遲不得落筆。網絡

直到今天,無心間在網上看到了一篇文檔,這篇文檔叫「跟我一塊兒寫make file」,做者是酷殼的陳皓,文檔不算短,pdf版本的有78頁。剛開始我只是隨便看看,可是慢慢的,我發現這篇文章寫的太好了,因爲我的對make file以前有所瞭解,一口氣花了5個小時的時間看完了這篇文章,可是並不以爲累,緣由很簡單,文章寫的很是通俗易懂,徹底是人家心得的東西,一看就是行家離手。文檔

看完這篇文章,我以爲我該說些什麼,關於寫技術博客的。博客

首先,什麼樣的東西應該寫,什麼樣的東西不應寫?class

說這個可能會刺痛不少人的神經,有句話是這麼說的:學比處於心得,業必歸於專精pdf

若是不是本身有所心得,那麼仍是不要寫了,不只本身沒有收穫,浪費了時間,對比人也沒有幫助。file

第二,當本身寫博客的時候問本身一個問題?對於要寫的東西,我本身吃透了麼,寫博客不是stackoverflow, 不是向別人問問題,一般是本身要闡述某個方面本身的心得,固然並非說不能夠討論,可是討論的前提是you have the knowledge。技術

第三,對於一篇博文的定位,是知識梳理的,或者新技術的,或者難點易錯的解析等等,定位好了才容易使一篇文章短小精悍,有形有神。總結

第四,對於博文標配的代碼,最好帶註釋,你是在寫文章,不是在寫代碼,好多人就直接貼一屏的代碼,就成了一片博文,難以理解。stackoverflow

第五,在對於博文闡述的技術進行交流的時候,要儘可能避免不禮貌的行爲,有些博文的做者文章寫的還行,可是往往和別人交流的時候就動輒罵娘,我的以爲非常不和諧,固然也可能事出有因,在此只是提出來,建議你們不要這樣作。註釋

第六,對於寫博文是某些博主的炫技(就像有錢人炫富),這種炫技是原本很簡單的東西,可能別人只不過是沒接觸過,做者卻把整個東西寫的很複雜,其實他內心很清楚,只不過是故意寫的很深奧,顯得本身很牛。

總結

固然做爲寫博客不該該有的狀況還有不少種,在此不可能窮舉出來,在某些方面我本身也作得不夠好,寫這篇文章算是對本身的總結和警示,固然也但願你們也思考一下該如何寫技術博客,另外,對於文章中說起的狀況,請不要對號入座。最後由於本人討厭口水戰,全部若是是溝通交流,歡迎指教,若是是口水戰,請繞道,對不起,對於沒意義的事情,兄弟沒時間。

相關文章
相關標籤/搜索