背景
- 技術文章的高品質主要展現在技術主題的明确、結構清晰、最重要就是幹貨滿滿。
- 為了達成這些目标,作者在構思文章時,需要考慮以下問題:如何将碎片化的知識變成體系化的輸出?主題怎麼寫?如何建構知識架構?知識會不會有錯誤,如何排查?在這個過程中,其實也是理清知識脈絡的過程。
主題明确
主題一定要明确,不僅文章标題就要切合,文中的小标題的命名也要點題明确。
- 如果你想寫一篇多線程的入門文章,那主題可以是這樣的:
- 《記Java多線程程式設計的第一次實踐》
- 《看了這個有趣的例子,你就秒懂多線程同步了》
- 《Java多線程入門概念整理》
- 如果你整理了很多Spring架構相關的筆記,需要把這些筆記整理成一篇技術架構文章,那主題可以這樣寫:
- 《Spring架構學習筆記十二篇》
- 《Spring架構總結與項目實踐》
結構清晰
- 确定好主題後,再梳理思路,根據主題将正文的核心部分羅列出來。有個比較通用的結構模闆,比如:
一、背景/前言
二、由于什麼原因,我們要做什麼事情…
三、遇到的問題/面臨的挑戰
四、遇到了什麼問題(成本、時間、難易程度)…
五、 如何解決?思路&方案介紹
六、業務有什麼方案?适不适合我?我打算如何做?我的切入點是什麼?
七、實踐的過程&解決了什麼問題
八、實踐過程遇到了什麼問題,如何分析解決的?能否沉澱輸出比較通用的方法論?
九、 總結&經驗&教訓
十、對這件事&項目的總結,收獲的教訓&獲得的經驗&總結
十一、 展望&未來規劃
幹貨
- 主題與結構都理清後,接着就是填充内容。内容最好是自己在技術學習與項目經曆中實際發生的總結:加入資料、截圖、簡練的代碼與注釋,項目中碰到的問題與解決方法讓文章具有現實感與臨時感,這樣有血有肉的文章才會真正讓人覺得幹貨滿滿。