方格精選

技術文章的寫作顧慮

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

在自家部落格寫初稿

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

抄襲的顧慮

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

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

假設我正在看一篇英文的技術文章,發現裡面有值得學習或記下的東西,我可能會先在心裡做部分翻譯,轉成我自己可以理解的語言。當值得記下的東西多到一個程度,覺得有點份量了,我會打開電腦或筆記本,把它們寫下來(當然也可能因為一時懶惰就隨時間淡忘了,這就很可惜)。
起初雖然像文抄公,但一開始動筆或敲鍵盤,往往會促使自己把原先想的東西再整理一遍,此時可能會發現一些遺漏的細節,或者新的想法。這些新發現,其中可能有些值得繼續延伸探索,或者深入,或者旁通,繼而發展成自己在學習過程的一條脈絡。循此脈絡所寫出來的東西,便增添了創作的成分,有了自己的生命;裡面或有前輩的研究成果,但也包含自己的心得與發現。
有人說,翻譯也是一種創作。從剛才描述的這個學習過程來看,翻譯也可以是通向創作的一個門徑吧。我翻譯的書籍雖然不多,但回頭來看,那些逐字逐句把英文翻譯成中文的日子,的確為我日後的技術寫作之路埋下一顆種子。
Keep writing!
為什麼會看到廣告
14會員
23內容數
這裡有我寫作與自行(獨立)出版電子書的實戰心得與相關知識,包括:寫作與出版工具的使用、各出版平台的比較、電子書上架的逐步教學、行銷技巧、以及持續進行的出版實驗心得與發現。 如果您也想了解如何自行出版電子書,歡迎一起來學習、相互切磋。
留言0
查看全部
發表第一個留言支持創作者!
閱讀|寫作|出版 的其他內容
我無意間從 Google 搜尋結果中發現自己的電子書被放在某個海盜網站上公開讓人下載,才想到自己已經很久沒有上網調查盜版的情形了。經我舉報,該網站已經被整個個撤銷(而不單單是下架我的作品頁面),文中也會簡述舉報過程。
「智者的常軌,乃雄心之明證。」W. H. Auden 所說的這句話,我認為幾乎可概括全書宏旨。其餘篇章有許多重複,可以跳著讀、選自己感興趣的作家/藝術家來讀。
我無意間從 Google 搜尋結果中發現自己的電子書被放在某個海盜網站上公開讓人下載,才想到自己已經很久沒有上網調查盜版的情形了。經我舉報,該網站已經被整個個撤銷(而不單單是下架我的作品頁面),文中也會簡述舉報過程。
「智者的常軌,乃雄心之明證。」W. H. Auden 所說的這句話,我認為幾乎可概括全書宏旨。其餘篇章有許多重複,可以跳著讀、選自己感興趣的作家/藝術家來讀。
本篇參與的主題策展
方格子、痞客邦、Fanbar 和 應援科技平臺的優缺點及其適用對象。讀者可以瞭解哪些平臺最適合自己的寫作需求,以及如何通過這些平臺實現內容變現。作者還分享了個人的使用經驗和對未來平臺的展望。對於創作者而言,選擇正確的平臺至關重要,能夠幫助他們更有效地與讀者互動並實現經濟回報。寫作變現、訂閱經濟
ChatGPT Canvas 是基於 GPT-4o 模型的全新動態界面,旨在提升寫作與程式開發的效率。它不僅提供智能編輯和寫作輔助功能,還支持程式碼轉換和錯誤修復,讓用戶能在更靈活的環境中創作。這篇文章介紹了 Canvas 的核心功能和使用流程,幫助使用者更好地瞭解如何利用此工具提升創作質量與效率。
方格子、痞客邦、Fanbar 和 應援科技平臺的優缺點及其適用對象。讀者可以瞭解哪些平臺最適合自己的寫作需求,以及如何通過這些平臺實現內容變現。作者還分享了個人的使用經驗和對未來平臺的展望。對於創作者而言,選擇正確的平臺至關重要,能夠幫助他們更有效地與讀者互動並實現經濟回報。寫作變現、訂閱經濟
ChatGPT Canvas 是基於 GPT-4o 模型的全新動態界面,旨在提升寫作與程式開發的效率。它不僅提供智能編輯和寫作輔助功能,還支持程式碼轉換和錯誤修復,讓用戶能在更靈活的環境中創作。這篇文章介紹了 Canvas 的核心功能和使用流程,幫助使用者更好地瞭解如何利用此工具提升創作質量與效率。
你可能也想看
Google News 追蹤
Thumbnail
這個秋,Chill 嗨嗨!穿搭美美去賞楓,裝備款款去露營⋯⋯你的秋天怎麼過?秋日 To Do List 等你分享! 秋季全站徵文,我們準備了五個創作主題,參賽還有機會獲得「火烤兩用鍋」,一起來看看如何參加吧~
Thumbnail
美國總統大選只剩下三天, 我們觀察一整週民調與金融市場的變化(包含賭局), 到本週五下午3:00前為止, 誰是美國總統幾乎大概可以猜到60-70%的機率, 本篇文章就是以大選結局為主軸來討論近期甚至到未來四年美股可能的改變
Thumbnail
最近經常會聽到ISCN 及 IPFS等相關詞彙,其中不外乎強調去中心化及保護創作者原始創作的著作權部分,今天我又突發奇想,想來針對著作權部分說說: 最近去中心化出版的字眼一職在我腦中迴繞,或許是因為這詞彙太新穎,我的小腦袋瓜還不大能吸收,但據我部份了解"IPFS"和"ISCN"的概念(或技術)其主要
Thumbnail
  在醫院工作很大的樂趣,就是可以陪伴個案慢慢進步,無論是身體上或心理層面,只要個案越來越好,自己也會從中得到很大的滿足。   張阿嬤是我很喜歡的個案,活潑討喜的她只要進到復健治療室,都會向每個人微笑打招呼。嬌小的身軀卻能發出極宏亮嗓音,「早安啊!」「老師我又來跟你請安了!」,為煩悶一成不變的病室帶
Thumbnail
常常有人說「人生不如意十之八九」,好像人生中只有充滿痛苦與無奈。但是,在這樣的痛苦中,是不是其實也收穫了些甚麼呢?《水澤文具店》和前一篇介紹的《解憂雜貨店》有些相似,但這家文具店不是寄信,而是為你寫小說......
切記!部落格文章不是寫學校作文啊! ‌ 我收到很多讀者詢問,因為覺得自己文筆不好,所以遲遲不敢開始寫部落格。 ‌ 妮娜剛開始寫文章前,也會一直懷疑自己,能不能寫出文章,因為小時候真的超討厭寫作文的!
Thumbnail
「技術寫作」也是文字工作者的一條出路,只是比較少為人知。
Thumbnail
從被邀請到這平台到現在,我依舊不知道寫什麼文章才好;但在朋友的提醒下,確實想起了第一次寫作的自己,查了一查,大約是六年前的三月...
Thumbnail
這個秋,Chill 嗨嗨!穿搭美美去賞楓,裝備款款去露營⋯⋯你的秋天怎麼過?秋日 To Do List 等你分享! 秋季全站徵文,我們準備了五個創作主題,參賽還有機會獲得「火烤兩用鍋」,一起來看看如何參加吧~
Thumbnail
美國總統大選只剩下三天, 我們觀察一整週民調與金融市場的變化(包含賭局), 到本週五下午3:00前為止, 誰是美國總統幾乎大概可以猜到60-70%的機率, 本篇文章就是以大選結局為主軸來討論近期甚至到未來四年美股可能的改變
Thumbnail
最近經常會聽到ISCN 及 IPFS等相關詞彙,其中不外乎強調去中心化及保護創作者原始創作的著作權部分,今天我又突發奇想,想來針對著作權部分說說: 最近去中心化出版的字眼一職在我腦中迴繞,或許是因為這詞彙太新穎,我的小腦袋瓜還不大能吸收,但據我部份了解"IPFS"和"ISCN"的概念(或技術)其主要
Thumbnail
  在醫院工作很大的樂趣,就是可以陪伴個案慢慢進步,無論是身體上或心理層面,只要個案越來越好,自己也會從中得到很大的滿足。   張阿嬤是我很喜歡的個案,活潑討喜的她只要進到復健治療室,都會向每個人微笑打招呼。嬌小的身軀卻能發出極宏亮嗓音,「早安啊!」「老師我又來跟你請安了!」,為煩悶一成不變的病室帶
Thumbnail
常常有人說「人生不如意十之八九」,好像人生中只有充滿痛苦與無奈。但是,在這樣的痛苦中,是不是其實也收穫了些甚麼呢?《水澤文具店》和前一篇介紹的《解憂雜貨店》有些相似,但這家文具店不是寄信,而是為你寫小說......
切記!部落格文章不是寫學校作文啊! ‌ 我收到很多讀者詢問,因為覺得自己文筆不好,所以遲遲不敢開始寫部落格。 ‌ 妮娜剛開始寫文章前,也會一直懷疑自己,能不能寫出文章,因為小時候真的超討厭寫作文的!
Thumbnail
「技術寫作」也是文字工作者的一條出路,只是比較少為人知。
Thumbnail
從被邀請到這平台到現在,我依舊不知道寫什麼文章才好;但在朋友的提醒下,確實想起了第一次寫作的自己,查了一查,大約是六年前的三月...