方格精選

技術文章的寫作顧慮

閱讀時間約 3 分鐘
早些年,當我有個點子,開始想要寫技術文章的時候,常有一些顧慮,致使我打消寫作的念頭。後來,我把這些想法整理出來,寫成文字,那層憂慮和壓力似乎就削減了些。也許這篇文章談到的問題不只限於技術寫作,而是所有嘗試寫作的人都可能碰到的問題。

在自家部落格寫初稿

有時覺得,有些主題,網路上已經有不少人寫了,我還要再多添一筆嗎?況且,又不見得寫得比別人豐富、深入、精彩。這想法會阻止我動筆。然而,從整理筆記、檢驗自己學習成果的角度來看,那種想法又顯得太消極了。
猶豫不決的話,不妨先在自己的部落格寫點初稿。畢竟是自家後院,只要不妨礙觀瞻,沒違反善良風俗,便無需顧慮太多。再者,寫完初稿之後,還可以反覆琢磨潤飾,改到自己滿意為止。

抄襲的顧慮

對於軟體程式之類的技術,如果不是第一線的研發人員或原作者,寫出來的文章大凡比較接近推廣、傳播,亦即經由第一手資料的咀嚼之後,再以自己的話來闡述,成就第二手、甚至第三、四手的參考資料。這樣的文章與所謂的第一手資料相比,自然缺了點創新,甚至有些地方會很相似;若擔心被旁人指謫抄襲或缺乏原創性,也是動筆的阻礙。
若撰文動機並非抄襲,並且在引用他人文句時適當加註、老實列出參考資料來源,應可避免剽竊抄襲之嫌。當然,如果一篇文章裡面有八九成都是引用他人的文章內容,誠實固然做到了,卻沒有太大的參考價值。
朱光潛在《談文學》中說:
「世間可想到、可說出的話在大體上都已經前人想過說過;然而後來人卻不能因此就不去想不去說,因為每個人有他的特殊的生活情境與經驗,所想所說的雖大體上仍是那樣的話,而想與說的方式卻各不相同。變遷了形式,就變遷了內容。所以他所想所說儘管在表面上仍是老生常談,而實際上卻可以是一種新鮮的作品,如果選擇與安排給了他一個新的形式、新的生命。」
這不僅適用於文學寫作,技術文章的寫作亦可如此看待。
所以重點在於,我們所寫出來的東西,是否真的是我們心裡所想的、所理解的、所感受的。如果是,那麼除了對自己有益之外,對此議題有興趣的人看到了,或許我們的文章表現方式正好與他們大腦的接收頻率相符,也就產生了額外的效益:讓更多人了解某項議題。這也是好事一樁。

從翻譯到寫筆記,再到創作

假設我正在看一篇英文的技術文章,發現裡面有值得學習或記下的東西,我可能會先在心裡做部分翻譯,轉成我自己可以理解的語言。當值得記下的東西多到一個程度,覺得有點份量了,我會打開電腦或筆記本,把它們寫下來(當然也可能因為一時懶惰就隨時間淡忘了,這就很可惜)。
起初雖然像文抄公,但一開始動筆或敲鍵盤,往往會促使自己把原先想的東西再整理一遍,此時可能會發現一些遺漏的細節,或者新的想法。這些新發現,其中可能有些值得繼續延伸探索,或者深入,或者旁通,繼而發展成自己在學習過程的一條脈絡。循此脈絡所寫出來的東西,便增添了創作的成分,有了自己的生命;裡面或有前輩的研究成果,但也包含自己的心得與發現。
有人說,翻譯也是一種創作。從剛才描述的這個學習過程來看,翻譯也可以是通向創作的一個門徑吧。我翻譯的書籍雖然不多,但回頭來看,那些逐字逐句把英文翻譯成中文的日子,的確為我日後的技術寫作之路埋下一顆種子。
Keep writing!
為什麼會看到廣告
avatar-img
14會員
23內容數
這裡有我寫作與自行(獨立)出版電子書的實戰心得與相關知識,包括:寫作與出版工具的使用、各出版平台的比較、電子書上架的逐步教學、行銷技巧、以及持續進行的出版實驗心得與發現。 如果您也想了解如何自行出版電子書,歡迎一起來學習、相互切磋。
留言0
查看全部
avatar-img
發表第一個留言支持創作者!
閱讀|寫作|出版 的其他內容
我無意間從 Google 搜尋結果中發現自己的電子書被放在某個海盜網站上公開讓人下載,才想到自己已經很久沒有上網調查盜版的情形了。經我舉報,該網站已經被整個個撤銷(而不單單是下架我的作品頁面),文中也會簡述舉報過程。
「智者的常軌,乃雄心之明證。」W. H. Auden 所說的這句話,我認為幾乎可概括全書宏旨。其餘篇章有許多重複,可以跳著讀、選自己感興趣的作家/藝術家來讀。
我無意間從 Google 搜尋結果中發現自己的電子書被放在某個海盜網站上公開讓人下載,才想到自己已經很久沒有上網調查盜版的情形了。經我舉報,該網站已經被整個個撤銷(而不單單是下架我的作品頁面),文中也會簡述舉報過程。
「智者的常軌,乃雄心之明證。」W. H. Auden 所說的這句話,我認為幾乎可概括全書宏旨。其餘篇章有許多重複,可以跳著讀、選自己感興趣的作家/藝術家來讀。
本篇參與的主題活動
隨著科技的進步,我們正在目睹一項長久以來被視為基本的技能逐漸被淡化 — — 寫作。根據美國技術作家 Paul Graham的觀察,他預測:未來會形成「會寫作」和「不會寫作」的社會
歡迎來到方格新手村第一站!參加方格主題活動,發表任何一篇貼文、文章加上指定標籤, 就有機會得到免費禮券,或是讓 vocus 把你的創作推薦給全站會員! 現在就完成新手村任務,讓更多人認識你!
說到閃閃發亮的時刻,還真有幾件回憶,可以值得說一下,但那些回憶大多都處在團體裡,類似那種革命情感的精神。大家一起排練、一起彩排、一起開會、一起討論、一起說笑、一起演出、一起慶功宴,那樣的回憶現在想起仍覺得心頭暖暖的。 但說到個人在人生舞台上單獨發光的時刻,大概就是躲在自己的溫暖小空間裡認真努力的模
本文探討作家在創作推理小說過程中所需具備的基本素養與技巧,透過《推理寫作祕笈》的案例分析,文章提供了目前推理小說的寫作要領,以及作家在面對創作困境時所需的實用建議,幫助讀者在字海中找到喘息之地,邁向成功的小說創作。文章同時提供相關的學習資源及創作交流平臺,鼓勵更多人參與推理小說的創作。
隨著科技的進步,我們正在目睹一項長久以來被視為基本的技能逐漸被淡化 — — 寫作。根據美國技術作家 Paul Graham的觀察,他預測:未來會形成「會寫作」和「不會寫作」的社會
歡迎來到方格新手村第一站!參加方格主題活動,發表任何一篇貼文、文章加上指定標籤, 就有機會得到免費禮券,或是讓 vocus 把你的創作推薦給全站會員! 現在就完成新手村任務,讓更多人認識你!
說到閃閃發亮的時刻,還真有幾件回憶,可以值得說一下,但那些回憶大多都處在團體裡,類似那種革命情感的精神。大家一起排練、一起彩排、一起開會、一起討論、一起說笑、一起演出、一起慶功宴,那樣的回憶現在想起仍覺得心頭暖暖的。 但說到個人在人生舞台上單獨發光的時刻,大概就是躲在自己的溫暖小空間裡認真努力的模
本文探討作家在創作推理小說過程中所需具備的基本素養與技巧,透過《推理寫作祕笈》的案例分析,文章提供了目前推理小說的寫作要領,以及作家在面對創作困境時所需的實用建議,幫助讀者在字海中找到喘息之地,邁向成功的小說創作。文章同時提供相關的學習資源及創作交流平臺,鼓勵更多人參與推理小說的創作。
你可能也想看
Google News 追蹤
Thumbnail
這個秋,Chill 嗨嗨!穿搭美美去賞楓,裝備款款去露營⋯⋯你的秋天怎麼過?秋日 To Do List 等你分享! 秋季全站徵文,我們準備了五個創作主題,參賽還有機會獲得「火烤兩用鍋」,一起來看看如何參加吧~
Thumbnail
11/20日NVDA即將公布最新一期的財報, 今天Sell Side的分析師, 開始調高目標價, 市場的股價也開始反應, 未來一週NVDA將重新回到美股市場的焦點, 今天我們要分析NVDA Sell Side怎麼看待這次NVDA的財報預測, 以及實際上Buy Side的倉位及操作, 從
Thumbnail
Hi 大家好,我是Ethan😊 相近大家都知道保濕是皮膚保養中最基本,也是最重要的一步。無論是在畫室裡長時間對著畫布,還是在旅途中面對各種氣候變化,保持皮膚的水分平衡對我來說至關重要。保濕化妝水不僅能迅速為皮膚補水,還能提升後續保養品的吸收效率。 曾經,我的保養程序簡單到只包括清潔和隨意上乳液
Thumbnail
最近經常會聽到ISCN 及 IPFS等相關詞彙,其中不外乎強調去中心化及保護創作者原始創作的著作權部分,今天我又突發奇想,想來針對著作權部分說說: 最近去中心化出版的字眼一職在我腦中迴繞,或許是因為這詞彙太新穎,我的小腦袋瓜還不大能吸收,但據我部份了解"IPFS"和"ISCN"的概念(或技術)其主要
Thumbnail
  在醫院工作很大的樂趣,就是可以陪伴個案慢慢進步,無論是身體上或心理層面,只要個案越來越好,自己也會從中得到很大的滿足。   張阿嬤是我很喜歡的個案,活潑討喜的她只要進到復健治療室,都會向每個人微笑打招呼。嬌小的身軀卻能發出極宏亮嗓音,「早安啊!」「老師我又來跟你請安了!」,為煩悶一成不變的病室帶
Thumbnail
常常有人說「人生不如意十之八九」,好像人生中只有充滿痛苦與無奈。但是,在這樣的痛苦中,是不是其實也收穫了些甚麼呢?《水澤文具店》和前一篇介紹的《解憂雜貨店》有些相似,但這家文具店不是寄信,而是為你寫小說......
切記!部落格文章不是寫學校作文啊! ‌ 我收到很多讀者詢問,因為覺得自己文筆不好,所以遲遲不敢開始寫部落格。 ‌ 妮娜剛開始寫文章前,也會一直懷疑自己,能不能寫出文章,因為小時候真的超討厭寫作文的!
Thumbnail
「技術寫作」也是文字工作者的一條出路,只是比較少為人知。
Thumbnail
從被邀請到這平台到現在,我依舊不知道寫什麼文章才好;但在朋友的提醒下,確實想起了第一次寫作的自己,查了一查,大約是六年前的三月...
Thumbnail
這個秋,Chill 嗨嗨!穿搭美美去賞楓,裝備款款去露營⋯⋯你的秋天怎麼過?秋日 To Do List 等你分享! 秋季全站徵文,我們準備了五個創作主題,參賽還有機會獲得「火烤兩用鍋」,一起來看看如何參加吧~
Thumbnail
11/20日NVDA即將公布最新一期的財報, 今天Sell Side的分析師, 開始調高目標價, 市場的股價也開始反應, 未來一週NVDA將重新回到美股市場的焦點, 今天我們要分析NVDA Sell Side怎麼看待這次NVDA的財報預測, 以及實際上Buy Side的倉位及操作, 從
Thumbnail
Hi 大家好,我是Ethan😊 相近大家都知道保濕是皮膚保養中最基本,也是最重要的一步。無論是在畫室裡長時間對著畫布,還是在旅途中面對各種氣候變化,保持皮膚的水分平衡對我來說至關重要。保濕化妝水不僅能迅速為皮膚補水,還能提升後續保養品的吸收效率。 曾經,我的保養程序簡單到只包括清潔和隨意上乳液
Thumbnail
最近經常會聽到ISCN 及 IPFS等相關詞彙,其中不外乎強調去中心化及保護創作者原始創作的著作權部分,今天我又突發奇想,想來針對著作權部分說說: 最近去中心化出版的字眼一職在我腦中迴繞,或許是因為這詞彙太新穎,我的小腦袋瓜還不大能吸收,但據我部份了解"IPFS"和"ISCN"的概念(或技術)其主要
Thumbnail
  在醫院工作很大的樂趣,就是可以陪伴個案慢慢進步,無論是身體上或心理層面,只要個案越來越好,自己也會從中得到很大的滿足。   張阿嬤是我很喜歡的個案,活潑討喜的她只要進到復健治療室,都會向每個人微笑打招呼。嬌小的身軀卻能發出極宏亮嗓音,「早安啊!」「老師我又來跟你請安了!」,為煩悶一成不變的病室帶
Thumbnail
常常有人說「人生不如意十之八九」,好像人生中只有充滿痛苦與無奈。但是,在這樣的痛苦中,是不是其實也收穫了些甚麼呢?《水澤文具店》和前一篇介紹的《解憂雜貨店》有些相似,但這家文具店不是寄信,而是為你寫小說......
切記!部落格文章不是寫學校作文啊! ‌ 我收到很多讀者詢問,因為覺得自己文筆不好,所以遲遲不敢開始寫部落格。 ‌ 妮娜剛開始寫文章前,也會一直懷疑自己,能不能寫出文章,因為小時候真的超討厭寫作文的!
Thumbnail
「技術寫作」也是文字工作者的一條出路,只是比較少為人知。
Thumbnail
從被邀請到這平台到現在,我依舊不知道寫什麼文章才好;但在朋友的提醒下,確實想起了第一次寫作的自己,查了一查,大約是六年前的三月...