方格精選

技術文章的寫作顧慮

更新於 發佈於 閱讀時間約 4 分鐘

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

raw-image

在自家部落格寫初稿

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

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

抄襲的顧慮

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

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

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

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

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

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

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

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

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

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

Keep writing!


留言
avatar-img
留言分享你的想法!
avatar-img
閱讀|寫作|出版
14會員
23內容數
這裡有我寫作與自行(獨立)出版電子書的實戰心得與相關知識,包括:寫作與出版工具的使用、各出版平台的比較、電子書上架的逐步教學、行銷技巧、以及持續進行的出版實驗心得與發現。 如果您也想了解如何自行出版電子書,歡迎一起來學習、相互切磋。
閱讀|寫作|出版的其他內容
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
每年4月、5月都是最多稅要繳的月份,當然大部份的人都是有機會繳到「綜合所得稅」,只是相當相當多人還不知道,原來繳給政府的稅!可以透過一些有活動的銀行信用卡或電子支付來繳,從繳費中賺一點點小確幸!就是賺個1%~2%大家也是很開心的,因為你們把沒回饋變成有回饋,就是用卡的最高境界 所得稅線上申報
Thumbnail
每年4月、5月都是最多稅要繳的月份,當然大部份的人都是有機會繳到「綜合所得稅」,只是相當相當多人還不知道,原來繳給政府的稅!可以透過一些有活動的銀行信用卡或電子支付來繳,從繳費中賺一點點小確幸!就是賺個1%~2%大家也是很開心的,因為你們把沒回饋變成有回饋,就是用卡的最高境界 所得稅線上申報
Thumbnail
初稿對我來說就是,只要有一瞬的靈感,或是一個可以咀嚼的詞彙、一種想寫下的心情,我可能都會嘗試化作文字,記下來。不帶任何批判,就只是把一些奇怪的、平凡的、枯燥的、神秘的東西,寫下來。不用成篇,不用成段,甚至也不用成句,標點文字錯誤也沒關係,只要能記下當下你有感的事物核心即可。
Thumbnail
初稿對我來說就是,只要有一瞬的靈感,或是一個可以咀嚼的詞彙、一種想寫下的心情,我可能都會嘗試化作文字,記下來。不帶任何批判,就只是把一些奇怪的、平凡的、枯燥的、神秘的東西,寫下來。不用成篇,不用成段,甚至也不用成句,標點文字錯誤也沒關係,只要能記下當下你有感的事物核心即可。
Thumbnail
數大就是美,寫的文章越多,越來越認為可以試著談一些題目,或許是一種推論,一種假設,先求有再求好,再不行就是請大家多見諒一些,大致上是如此。雖然出自於自身的經驗所得出的結論不見得準確,但也是在提出一種看法。如果說會有沒靈感的時候,那就是寫到自己所不擅長的題目。既然知道不擅長卻又要去寫,那當然就是一種自
Thumbnail
數大就是美,寫的文章越多,越來越認為可以試著談一些題目,或許是一種推論,一種假設,先求有再求好,再不行就是請大家多見諒一些,大致上是如此。雖然出自於自身的經驗所得出的結論不見得準確,但也是在提出一種看法。如果說會有沒靈感的時候,那就是寫到自己所不擅長的題目。既然知道不擅長卻又要去寫,那當然就是一種自
Thumbnail
遇到寫作困境時,我們應將目光由內部轉向外部! 其實,只要去「記錄」別人的事情,就能找到無盡的寫作靈感。 以下是3個初學者常遇到的迷思,突破他們,你就能批量生產優質文章: 迷思1 - 擔心剽竊了他人的內容:當你關注別人的事物時,其實不必過於擔心剽竊。只要明白,這些都是你「只是」你聽到的故事,適當的改寫
Thumbnail
遇到寫作困境時,我們應將目光由內部轉向外部! 其實,只要去「記錄」別人的事情,就能找到無盡的寫作靈感。 以下是3個初學者常遇到的迷思,突破他們,你就能批量生產優質文章: 迷思1 - 擔心剽竊了他人的內容:當你關注別人的事物時,其實不必過於擔心剽竊。只要明白,這些都是你「只是」你聽到的故事,適當的改寫
Thumbnail
當今書法藝術愛好者算很小眾,每每在網路上搜尋書法相關資料,不是農場文就是未註明作者出處的殘篇,有些資料讀起來雖然有趣,但總覺得不太可靠,於是我興起把讀過的資料做個紀錄的念頭,讓共同興趣的網友能找到可用參考書或文章。 剛開始在網路發表文章
Thumbnail
當今書法藝術愛好者算很小眾,每每在網路上搜尋書法相關資料,不是農場文就是未註明作者出處的殘篇,有些資料讀起來雖然有趣,但總覺得不太可靠,於是我興起把讀過的資料做個紀錄的念頭,讓共同興趣的網友能找到可用參考書或文章。 剛開始在網路發表文章
Thumbnail
只是一篇抒發文,在被抄襲之後。
Thumbnail
只是一篇抒發文,在被抄襲之後。
Thumbnail
創作透過發表,會有新的意義和互動,而不僅僅是獨白。
Thumbnail
創作透過發表,會有新的意義和互動,而不僅僅是獨白。
追蹤感興趣的內容從 Google News 追蹤更多 vocus 的最新精選內容追蹤 Google News