筆記 - Google Technical Writing Courses 1/

Reference: Technical Writing One introduction

Words And Active Voice

1. 如果有字彙對讀者比較陌生的，記得在開頭定義好它。如果有多個，蒐集起來，開一個f專區分別定義好它。

2. 保持用詞一致性。不要前面說桂冠湯圓，後面寫糯米丸。如果硬要兩個寫法，可以緊跟著主要用詞補充在括號內。

桂冠湯圓(糯米丸)真的好吃。
口胡！桌上的十顆糯米丸，怎麼都被媽媽吃光惹。

3. 謹慎使用縮寫。縮寫優點是可以有效縮減句子長度。但亦會增加多一層的抽象性，需要消耗一些腦力。

• 如果詞彙不常出現，就不要用縮寫。
• 詞彙的縮寫真的真的比全稱還短，才去使用它。

4. 不要使用會產生困惑的代名詞。

• 前面提到兩個名詞，後面卻用它。到底是前面的還是後面的？
• 前面提到多個名詞，後面用了這個、那個。到底哪個是哪個。
• 代名詞會產生混肴的話，乾脆不要用了，直接用全名還比較好。

5. 主動與被動相比，傾向使用主動式語句。被動語句在讀者腦中還要多轉一手，沒有增加好處。主動式會讓句子讀起來比較簡單。很多科學期刊也慢慢鼓勵多使用主動式。

Clear sentences

1. 動詞是句子的核心元件。挑選更多樣性、更精確、更強烈的動詞，來讓你的句子有簡潔又有力量。

2. 弱的動詞像是"發生惹"(happen/occur)、"是..."(be動詞)。想辦法用更明確的動詞來替代。

❌ 當Lomo肚子餓惹，就有一個神祕的聲響[發生]，
✔️ Lomo的肚子餓[發出]神祕的聲響。

❌ Lomo is very careful to ensure Nini is not that.
✔️ 改成: Lomo carefully ensure Nini is not that.

4. 句子中用到很多弱/通用動詞，通常是一種徵兆。表示是你可能不經意地用了被動式，或是用詞不夠精準，更甚至是少了句子的主詞。

5. 絕大部分的 There is/there are 都是冗冗的。試著拿掉它改寫看看，會讓句子更簡潔。

6. 減少使用飄渺的形容詞。RD需要的是精確的描述。

❌ Lomo 睡了靠北久才醒來。
✔️ 改成 Lomo 比昨天多睡了四個小時才醒來。

Short sentences /1

1. 一樣的內容，句子寫越短越好。

• 短的文章，比較好讀。
• 短的文章，比較好維護。
• 句子越多，越有可能出錯。

就跟寫 Code 一樣，儘量精簡並精確。

2. 每一行句子只描述一個想法。不要在句點前，描述超過兩件事情。SRP/Single Responsibility Principle。

3. 如果一個句子要講的東西太多，可以試着轉化成列表(list)。兩三行的字句，排成整齊格式的列表。

4. 減少語言癌

• at this point in time 改 now
• determine the location of 改 find
• causes the triggering of 改 trigger
• provide a detail description of 改 describe

Short sentences /2

5. 減少使用從屬子句。根據一個句子一個想法，如果從屬子句是在延伸"主句"的想法，那就可以保留。如果是已經在描述別的意思，就把它拆解會比較好。

❌ Lomo is a cat that is big and white, which likes chasing Nini all the time.
✔️ 又大又白是在加強 Lomo 這隻貓的介紹。很愛追Nini是別件事情，可以分成另一個句子。

6. 區分 which 跟 that 的差別。如果你的句子講到子句前會緩一下，那就用 which；如果子句講過去非常順不會停，通常會使用 that 來連接。

Next Note

1. Lists and Tables
2. Paragraphs
3. Audience
4. Documents
5. Punctuation