分享寫技術部落格的注意事項

2022-08-13 21:51:12 字數 1369 閱讀 6605

個人認為寫部落格(blogging)是技術總結的最佳方式,甚至可以這樣子講,部落格就是積累,從一定角度上講是醬紫的。可能是受規範約束習慣了,感覺寫部落格也有一些注意事項,雖然之前寫了很多文章,但感覺都不是很規範,現總結寫部落格應該注意的幾點,以隨時提醒自己。

對於那些在官方文件中都講的很清楚的東西就沒有必要再進行重複了,給出相應的鏈結就好了。特別是對於像msdn這種非常豐富的官方文件,最好不要去重複它的內容,因為你不一定比官方講的清楚。重點應該放在自己的心得,體會和總結等,這樣於自己是真正的總結和積累,能變成經驗,於他人也是一種有價值的參考的。

前面說了不要重複文件,那應該寫什麼呢?愚認為,應該是自己經過實踐之後的總結:

如果是受他人的部落格或**的啟發,最好把關鍵的句子段落引用出來,然後再寫自己的思考和討論。在文章中再給出原文或出處的鏈結,這樣以顯得尊重和專業。

對於**我們都有版本控制系統來幫助維護修改記錄。但對於文件,也建議這樣做。對於部落格,可能沒有(或許我不知道)類似的工具,但可以手動來說明。比如在部落格的頭部或尾部加上修訂歷史記錄,或者在文章中把後來的修改用其他字型標明,或者用括號或腳注來說明。這樣自已日後看起來也很方便,也能看到自己的思考過程和成長過程。

講的越詳細越好,範圍越小越好,但要深入的講,正如那句話,十個百分之十不如乙個百分之百。如果你不能深入的講,證明你還沒有到寫的時候,應試再去學習或者實踐,直到你能講的很清楚,講的很詳細,講的很深入的時候再來總結和寫部落格。爭取做到一篇文章乙個點,這樣文章多了就成了網最後變成沒有漏洞的面。

這可能是對於寫作的通用要求,說起來容易,但是做起來就比較困難。其實也不難,主要表現在:

有沒有一種感覺,這好像是在講編碼規範,沒錯,很早就有人講過,寫文章跟寫**是一樣的。所以,作為程式設計師的我們,可以考慮用寫**的一切,包括習慣,規範來寫文章。

這就好比寫完**後的除錯與測試。好**是改出來的,好文章也是如此。能夠一蹴而就的人有,但很少。即使是像魯迅那樣的大作家寫文章都還需要修改,都沒有一次成型的,更何況我們呢?在寫完文章後也視情況對文章進行除錯和重構,直到自己讀起來感到滿意和舒服為止。試想,如果自己寫的文章自已都不想看,別人會看嗎?我們又不是在寫作業,不管好壞老師總會看,而且要仔細的看。要想寫出好文章,必須首先讓自己認為是好文章。

好的技術文章應該都非常容易看懂,即使你對所說的那門科學完全不知。去讀一讀《code complete》等之類的經典書籍的英文原版,你會發現,其實看原版書並不需要多麼nb的英語水平,可以不客氣的講上過大學的人應該都能看懂。其實這重點不在你懂不懂英語,而是要看作者能否用最易懂的語言來把事情表達清楚。這確實是一種能力,平常我們所謂的溝通能力,也基本上就在這,看你能否用最簡單的語言把事情表達清楚,讓另一方聽明白。

這裡有一些技巧:

有圖有真相,有**有真相。說完了,講過了,最好附上真實事例,**和截圖。否則別人可能會質疑,至少我在看到別人只「說」,沒「做」的時候會質疑的。

寫技術部落格的注意事項

個人認為寫部落格 blogging 是技術總結的最佳方式,甚至可以這樣子講,部落格就是積累,從一定角度上講是醬紫的。可能是受規範約束習慣了,感覺寫部落格也有一些注意事項,雖然之前寫了很多文章,但感覺都不是很規範,現總結寫部落格應該注意的幾點,以隨時提醒自己。對於那些在官方文件中都講的很清楚的東西就沒...

寫技術部落格的注意事項

出處 個人認為寫部落格 blogging 是技術總結的最佳方式,甚至可以這樣子講,部落格就是積累,從一定角度上講是醬紫的。可能是受規範約束習慣了,感覺寫部落格也有一些注意事項,雖然之前寫了很多文章,但感覺都不是很規範,現總結寫部落格應該注意的幾點,以隨時提醒自己。對於那些在官方文件中都講的很清楚的東...

寫技術部落格的注意事項

個人認為寫部落格 blogging 是技術總結的最佳方式,甚至可以這樣子講,部落格就是積累,從一定角度上講是醬紫的。可能是受規範約束習慣了,感覺寫部落格也有一些注意事項,雖然之前寫了很多文章,但感覺都不是很規範,現總結寫部落格應該注意的幾點,以隨時提醒自己。對於那些在官方文件中都講的很清楚的東西就沒...