方格精選

技術文章的寫作顧慮

更新 發佈閱讀 4 分鐘

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

raw-image

在自家部落格寫初稿

有時覺得,有些主題,網路上已經有不少人寫了,我還要再多添一筆嗎?況且,又不見得寫得比別人豐富、深入、精彩。這想法會阻止我動筆。然而,從整理筆記、檢驗自己學習成果的角度來看,那種想法又顯得太消極了。

猶豫不決的話,不妨先在自己的部落格寫點初稿。畢竟是自家後院,只要不妨礙觀瞻,沒違反善良風俗,便無需顧慮太多。再者,寫完初稿之後,還可以反覆琢磨潤飾,改到自己滿意為止。

抄襲的顧慮

對於軟體程式之類的技術,如果不是第一線的研發人員或原作者,寫出來的文章大凡比較接近推廣、傳播,亦即經由第一手資料的咀嚼之後,再以自己的話來闡述,成就第二手、甚至第三、四手的參考資料。這樣的文章與所謂的第一手資料相比,自然缺了點創新,甚至有些地方會很相似;若擔心被旁人指謫抄襲或缺乏原創性,也是動筆的阻礙。

若撰文動機並非抄襲,並且在引用他人文句時適當加註、老實列出參考資料來源,應可避免剽竊抄襲之嫌。當然,如果一篇文章裡面有八九成都是引用他人的文章內容,誠實固然做到了,卻沒有太大的參考價值。

朱光潛在《談文學》中說:

「世間可想到、可說出的話在大體上都已經前人想過說過;然而後來人卻不能因此就不去想不去說,因為每個人有他的特殊的生活情境與經驗,所想所說的雖大體上仍是那樣的話,而想與說的方式卻各不相同。變遷了形式,就變遷了內容。所以他所想所說儘管在表面上仍是老生常談,而實際上卻可以是一種新鮮的作品,如果選擇與安排給了他一個新的形式、新的生命。」

這不僅適用於文學寫作,技術文章的寫作亦可如此看待。

所以重點在於,我們所寫出來的東西,是否真的是我們心裡所想的、所理解的、所感受的。如果是,那麼除了對自己有益之外,對此議題有興趣的人看到了,或許我們的文章表現方式正好與他們大腦的接收頻率相符,也就產生了額外的效益:讓更多人了解某項議題。這也是好事一樁。

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

假設我正在看一篇英文的技術文章,發現裡面有值得學習或記下的東西,我可能會先在心裡做部分翻譯,轉成我自己可以理解的語言。當值得記下的東西多到一個程度,覺得有點份量了,我會打開電腦或筆記本,把它們寫下來(當然也可能因為一時懶惰就隨時間淡忘了,這就很可惜)。

起初雖然像文抄公,但一開始動筆或敲鍵盤,往往會促使自己把原先想的東西再整理一遍,此時可能會發現一些遺漏的細節,或者新的想法。這些新發現,其中可能有些值得繼續延伸探索,或者深入,或者旁通,繼而發展成自己在學習過程的一條脈絡。循此脈絡所寫出來的東西,便增添了創作的成分,有了自己的生命;裡面或有前輩的研究成果,但也包含自己的心得與發現。

有人說,翻譯也是一種創作。從剛才描述的這個學習過程來看,翻譯也可以是通向創作的一個門徑吧。我翻譯的書籍雖然不多,但回頭來看,那些逐字逐句把英文翻譯成中文的日子,的確為我日後的技術寫作之路埋下一顆種子。

Keep writing!


留言
avatar-img
一步研究室|獨立出版筆記
15會員
24內容數
一步出版致力將複雜知識轉化為可實踐、可累積的行動, 陪伴讀者以穩定的一小步,持續走向進步的道路。
2024/05/02
本文整理了有關技術文件寫作的重要觀念,包括 docs as a product、內容優先,並說明如何構思文件架構。
Thumbnail
2024/05/02
本文整理了有關技術文件寫作的重要觀念,包括 docs as a product、內容優先,並說明如何構思文件架構。
Thumbnail
2024/05/01
本文主要在討論以 Docs as Code 方法來撰寫技術文件,此做法能否滿足企業內部對知識管理的需求。
Thumbnail
2024/05/01
本文主要在討論以 Docs as Code 方法來撰寫技術文件,此做法能否滿足企業內部對知識管理的需求。
Thumbnail
2023/04/15
摘要:讓 Obsidian 預設以新頁籤來開啟檔案的幾個方法。
Thumbnail
2023/04/15
摘要:讓 Obsidian 預設以新頁籤來開啟檔案的幾個方法。
Thumbnail
看更多
你可能也想看
Thumbnail
賽勒布倫尼科夫以流亡處境回望蘇聯電影導演帕拉贊諾夫的舞台作品,以十段寓言式殘篇,重新拼貼記憶、暴力與美學,並將審查、政治犯、戰爭陰影與「形式即政治」的劇場傳統推到台前。本文聚焦於《傳奇:帕拉贊諾夫的十段殘篇》的舞台美術、音樂與多重扮演策略,嘗試解析極權底下不可言說之事,將如何成為可被觀看的公共發聲。
Thumbnail
賽勒布倫尼科夫以流亡處境回望蘇聯電影導演帕拉贊諾夫的舞台作品,以十段寓言式殘篇,重新拼貼記憶、暴力與美學,並將審查、政治犯、戰爭陰影與「形式即政治」的劇場傳統推到台前。本文聚焦於《傳奇:帕拉贊諾夫的十段殘篇》的舞台美術、音樂與多重扮演策略,嘗試解析極權底下不可言說之事,將如何成為可被觀看的公共發聲。
Thumbnail
柏林劇團在 2026 北藝嚴選,再次帶來由布萊希特改編的經典劇目《三便士歌劇》(The Threepenny Opera),導演巴里・柯斯基以舞台結構與舞台調度,重新向「疏離」進行提問。本文將從觀眾慾望作為戲劇內核,藉由沉浸與疏離的辯證,解析此作如何再次照見觀眾自身的位置。
Thumbnail
柏林劇團在 2026 北藝嚴選,再次帶來由布萊希特改編的經典劇目《三便士歌劇》(The Threepenny Opera),導演巴里・柯斯基以舞台結構與舞台調度,重新向「疏離」進行提問。本文將從觀眾慾望作為戲劇內核,藉由沉浸與疏離的辯證,解析此作如何再次照見觀眾自身的位置。
Thumbnail
本文深入解析臺灣劇團「晃晃跨幅町」對易卜生經典劇作《海妲.蓋柏樂》的詮釋,從劇本歷史、聲響與舞臺設計,到演員的主體創作方法,探討此版本如何讓經典劇作在當代劇場語境下煥發新生,滿足現代觀眾的觀看慾望。
Thumbnail
本文深入解析臺灣劇團「晃晃跨幅町」對易卜生經典劇作《海妲.蓋柏樂》的詮釋,從劇本歷史、聲響與舞臺設計,到演員的主體創作方法,探討此版本如何讓經典劇作在當代劇場語境下煥發新生,滿足現代觀眾的觀看慾望。
Thumbnail
《轉轉生》為奈及利亞編舞家庫德斯.奧尼奎庫與 Q 舞團創作的當代舞蹈作品,融合舞蹈、音樂、時尚和視覺藝術,透過身體、服裝與群舞結構,回應殖民歷史、城市經驗與祖靈記憶的交錯。本文將從服裝設計、身體語彙與「輪迴」的「誕生—死亡—重生」結構出發,分析《轉轉生》如何以當代目光,形塑去殖民視角的奈及利亞歷史。
Thumbnail
《轉轉生》為奈及利亞編舞家庫德斯.奧尼奎庫與 Q 舞團創作的當代舞蹈作品,融合舞蹈、音樂、時尚和視覺藝術,透過身體、服裝與群舞結構,回應殖民歷史、城市經驗與祖靈記憶的交錯。本文將從服裝設計、身體語彙與「輪迴」的「誕生—死亡—重生」結構出發,分析《轉轉生》如何以當代目光,形塑去殖民視角的奈及利亞歷史。
Thumbnail
初稿對我來說就是,只要有一瞬的靈感,或是一個可以咀嚼的詞彙、一種想寫下的心情,我可能都會嘗試化作文字,記下來。不帶任何批判,就只是把一些奇怪的、平凡的、枯燥的、神秘的東西,寫下來。不用成篇,不用成段,甚至也不用成句,標點文字錯誤也沒關係,只要能記下當下你有感的事物核心即可。
Thumbnail
初稿對我來說就是,只要有一瞬的靈感,或是一個可以咀嚼的詞彙、一種想寫下的心情,我可能都會嘗試化作文字,記下來。不帶任何批判,就只是把一些奇怪的、平凡的、枯燥的、神秘的東西,寫下來。不用成篇,不用成段,甚至也不用成句,標點文字錯誤也沒關係,只要能記下當下你有感的事物核心即可。
Thumbnail
數大就是美,寫的文章越多,越來越認為可以試著談一些題目,或許是一種推論,一種假設,先求有再求好,再不行就是請大家多見諒一些,大致上是如此。雖然出自於自身的經驗所得出的結論不見得準確,但也是在提出一種看法。如果說會有沒靈感的時候,那就是寫到自己所不擅長的題目。既然知道不擅長卻又要去寫,那當然就是一種自
Thumbnail
數大就是美,寫的文章越多,越來越認為可以試著談一些題目,或許是一種推論,一種假設,先求有再求好,再不行就是請大家多見諒一些,大致上是如此。雖然出自於自身的經驗所得出的結論不見得準確,但也是在提出一種看法。如果說會有沒靈感的時候,那就是寫到自己所不擅長的題目。既然知道不擅長卻又要去寫,那當然就是一種自
Thumbnail
遇到寫作困境時,我們應將目光由內部轉向外部! 其實,只要去「記錄」別人的事情,就能找到無盡的寫作靈感。 以下是3個初學者常遇到的迷思,突破他們,你就能批量生產優質文章: 迷思1 - 擔心剽竊了他人的內容:當你關注別人的事物時,其實不必過於擔心剽竊。只要明白,這些都是你「只是」你聽到的故事,適當的改寫
Thumbnail
遇到寫作困境時,我們應將目光由內部轉向外部! 其實,只要去「記錄」別人的事情,就能找到無盡的寫作靈感。 以下是3個初學者常遇到的迷思,突破他們,你就能批量生產優質文章: 迷思1 - 擔心剽竊了他人的內容:當你關注別人的事物時,其實不必過於擔心剽竊。只要明白,這些都是你「只是」你聽到的故事,適當的改寫
Thumbnail
當今書法藝術愛好者算很小眾,每每在網路上搜尋書法相關資料,不是農場文就是未註明作者出處的殘篇,有些資料讀起來雖然有趣,但總覺得不太可靠,於是我興起把讀過的資料做個紀錄的念頭,讓共同興趣的網友能找到可用參考書或文章。 剛開始在網路發表文章
Thumbnail
當今書法藝術愛好者算很小眾,每每在網路上搜尋書法相關資料,不是農場文就是未註明作者出處的殘篇,有些資料讀起來雖然有趣,但總覺得不太可靠,於是我興起把讀過的資料做個紀錄的念頭,讓共同興趣的網友能找到可用參考書或文章。 剛開始在網路發表文章
Thumbnail
只是一篇抒發文,在被抄襲之後。
Thumbnail
只是一篇抒發文,在被抄襲之後。
Thumbnail
創作透過發表,會有新的意義和互動,而不僅僅是獨白。
Thumbnail
創作透過發表,會有新的意義和互動,而不僅僅是獨白。
Thumbnail
你不用是一個創作大師才能接寫作案,但是有幾件事情,在變現之前就能先搞定的話會好很多。 這三件事分別是「磨練寫作技術」、「不要怪自己」、「相信自己的選擇」。 完蛋,寫到這裡聽起來好雲,但我真的是接案之後才對這三件事非常有感,對於精神健康來說XDD
Thumbnail
你不用是一個創作大師才能接寫作案,但是有幾件事情,在變現之前就能先搞定的話會好很多。 這三件事分別是「磨練寫作技術」、「不要怪自己」、「相信自己的選擇」。 完蛋,寫到這裡聽起來好雲,但我真的是接案之後才對這三件事非常有感,對於精神健康來說XDD
追蹤感興趣的內容從 Google News 追蹤更多 vocus 的最新精選內容追蹤 Google News