張鑫旭12年技術寫作經驗分享直播內容總結

語言: CN / TW / HK

張鑫旭大大在2月15號直播分享了他十二年寫作經驗,當天正好趕上疫情被抓去測核酸,時隔兩天還是急忙補上了這一課。講的是真的非常好,特此邊聽邊記錄講解的要點並加上了自己的一些理解,希望對自己對大家在技術文章創作上有所幫助

直播講師:張鑫旭

講師介紹:閱文集團前端技術專家,同時也是鑫空間鑫生活博主,十幾年來一直筆耕不綴,創作了接近800篇前端技術原創文章,並著有書籍《CSS世界》《CSS選擇器世界》和《CSS新世界》,在與使用者體驗相關的前端領域有較多的研究心得。

直播回放地址

關於文章選題

為什麼會想不到分享的東西呢?

原因一:總想搞波大的

  • 要牛逼
  • 要稀缺
  • 要精緻
  • 要乾貨

原因二:害怕失敗帶來的不安全感而不自信

  • 要是內容不行
  • 要是版式糟糕
  • 要是暴露我是菜鳥
  • 我會不會社死

1.當然,做技術的人性格上都會帶上一點完美主義,比如前端er們應該飽受過UI的摧殘:這個間距小了一丟丟,這個字型顏色深了一點點等等等等,經歷多了就養成了一絲不苟的精神(笑)

2.我個人寫作的心裡歷程:這寫的不嚴謹怎麼辦?感覺自己寫不出花樣,寫的像抄別人的怎麼辦?會不會被噴?這排版會不會太醜?要不要請教下UI小姐姐?(好像挺不錯)

如何解決?

應該想的是我有什麼

  • 我是誰
  • 我的精力多少
  • 我的水平如何
  • 我的優勢是什麼
  • 我的突破口在哪裡

個人覺得寫文章是一個梳理自己所掌握能力的過程,所以一定先要對自己有一個全面的認知。

然後根據所要撰寫的內容查缺補漏,甚至於錦上添花

每個人都是不同的個體,不太可能寫出完全一樣的風格的文章,所以大膽地用自己的想法去創作,創作完成後我覺得會對個人產生良好的正向激勵

寫作選題

  1. 新特性、新方法的介紹

    推薦網站 Can I use,一個專門對前端 API 做相容性測試的網站,有非常多的新特性,可以找一些常人不知道的 API 寫一寫用法,原理什麼的

  2. 自認為厲害的小技巧、小創造

  3. 原理剖析、深入理解

  4. 技術方案彙總

  5. 棘手問題解決經驗分享

  6. 優秀框架、專案、工具的體驗指南

第1、4、6點是比較適合新人的選題

一些建議

  1. 選題與自己學習相關

    • 寫作是學習的輔助手段
    • 容易堅持,就算沒人看,自己收穫了成長
  1. 不要寫雷同內容

    • 同一個知識點從不同點切入
  1. 迷茫的時候寫寫個人故事、感悟與困惑

    • 技能尋找答案,又能獲得訪問

1.我經常在工作中學習新知識,因為進公司較早,對經手的專案都有主要負責權,所以經常會往專案裡塞一些我正在學習的新知識甚至新框架,這樣工作學習兩不誤,成長飛快

2.作為初學者都需要養成記筆記的習慣,就像人生的第四大錯覺:我收藏了=我會了,又多了人生的第五大錯覺:我記了筆記=我也能寫出這樣的文章。記得多了,到自己來還是能劃拉兩下子的

3.沒錯,這篇文章就是我在迷茫中才想著要寫出來的

關於內容結構

你寫作的目的是什麼?

如果是功利寫作

為了升職加薪,為了換工作,為了出名

重點突出

一眼掃去知道你在講什麼

  • 講結論的結論先行
  • 講互動的效果先行
  • 羅列知識的目錄清晰

有閉環有遞進

完整的故事化表達

  • 背景,思考,嘗試,困難,解決與結果
  • 困難分1,2,3,解決後又出現了什麼新問題

寫技術文章要避免像寫論文一樣,技術文章需要的是活躍的表述能力,不僅能吸引他人閱讀,更能展現個人解決問題的能力,這樣更容易收穫面試官的青睞

如果是日常寫作

為了學習與自我成長,個人展現

遵循自己內心

不要搞花裡胡哨的套路,想怎麼寫就怎麼寫

案例一:開篇1000字碎碎念 獲取元素CSS值之getComputedStyle方法熟悉

案例二:微信對話體 我們一起學習CSS image-set()

案例三:同人小說包裝 客棧說書:CSS遮罩CSS3 mask/masks詳細介紹

總結

如果你擁有足夠的習作自由

多些真誠,少些套路

真心想分享的心比什麼亂七八糟的技巧都管用

關於語言表達

技術文章的語言表達,什麼是最重要的?

  • 簡介的語句?X
  • 華麗的辭藻?X
  • 高效的段子?X

最重要的應該是換位思考的能力

image.png

什麼是換位思考

  • 如果我是小白,這些術語懂嗎?

  • 如果我是讀者,好理解嗎?

    是不是用個耳熟能詳的東西類比下?

    是不是程式碼要簡化下,加上註釋?

    是不是這裡應該放個圖?

    是不是這裡應該加個演示?

展現真實的自己

鑫旭大佬的觀點:

除了是工作彙報、團隊賬號這樣的嚴肅場景,否則一定是融入了個人情感的文章更有價值

這點很有感觸,平常關注的公眾號,或者博主,技術不一定是特別牛逼的,但文章都是寫的比較生動有趣,引經據典(不是),讓人有閱讀下去的吸引力。如果文章不生動那還不如直接去看官方文件API

那麼如何展示真實的自己呢?

  • 例如:

    我遇到了什麼樣的問題?我是怎麼思考的?我又是怎麼解決的?

  • 又例如:

    我覺得這個技術如何?我不太喜歡某某設計?我的建議是什麼?

  • 你是什麼樣的人,就使用什麼樣的風格

    我話癆,喜歡扯東扯西,你就這麼幹,想到什麼講什麼

    我御宅族,挺好,文章可以體現各種宅元素

    我喜歡晒自己,那文章配圖就多多展現

    我是窮酸小透明,過得不如意,文章就不必強顏歡笑,透露出憂鬱挺好

  • 保持一致的風格和特色

    不要這篇嘻嘻哈哈,那篇文章乾乾巴巴

    • 糟糕的風格好於毫無風格
    • 讓別人記住你,提高影響力
    • 是防盜版的手段之一

關於文章質量

文章質量很重要

10篇水文不如1篇高質量文章

除了內容本身質量以外,提高文章質量的一些技巧:

配圖和演示

一例勝千圖,一圖勝前言

示例:CSS 實現多行文字“展開收起” - 掘金

image.png

對每一句話負責

出現了不確信的結論,一定要自己驗證一遍

示例:

在桌面端document.scrollingElement就是document.documentElement

在移動端documenet.scrollingElement就是document.body

試了下第一個是對的

第二個 Android 和 IOS 都要考慮,限於環境有限,就交給評論區啦

追尋內心而不是熱門

文章質量和訪問量並不正相關

示例:

面試技巧,N個特性彙總這樣的文章容易高贊!

但,這些文章作者我一個都沒記住

我在掘金髮了兩篇文章,一個自己寫的關於原型鏈的,沒有多少閱讀量也沒有贊,一個彙總移動端開發的內容確實閱讀量高,贊也多(相對於0來說),贊雖多,卻沒有自己寫的對自己的提升大,因為彙總的都是別人的成果

總結

  1. 關於文章選題

    與學習相關、不同切入點、感悟與困惑

  1. 關於內容結構

    重點突出、閉環與遞進、整成

  1. 關於語言表達

    換位思考、展示自我、保持風格

  1. 關於文章質量

    配圖與例項、對結論負責、追尋內心