#筆記
需要『粗用』的平價水彩筆,譬如故意讓筆毛開花來畫效果的…但不要尼龍毛,儘量台製…
PTT文具版有文提到去年推出的正德紫貂筆。嗯嗯試著記住這個品牌…正德正德正德等大人 :bgcat_swing:
郭台銘的永齡基金會每月支付『歷久』十萬元來「協助立委職務」,而『Z9』回捐5萬元助理薪水給高虹安(立委辦公室) :goose_duck_deepblue:
*究竟喝黑豆水會不會影響婦科健康與疾病呢?
雷小玲營養師說明,其實黑豆水也適合體質偏寒涼的女性調養身體,而最佳的日常調養時間落在經期的前後,但在行經期間少量飲用也是OK的。
*大豆異黃酮除了有類似雌激素的效果,同時也具有「拮抗作用」:當體內雌激素減少,大豆異黃酮能補足雌激素的作用;同時也能抑制體內過多的雌激素與受體結合,進而降低乳癌、子宮頸癌風險。因此民眾可以安心食用黑豆、黑豆製品。
來自早安健康的文章
https://www.edh.tw/article/24703
教練筆記|對於主管的不滿,我應加倍奉還、討回公道還是…?
A君曾與我共事多年,最近萌生離職想法,起因是對主管的不滿,想要諮詢我的看法...
https://matters.news/@richardview/383470-教練筆記-對於主管的不滿-我應加倍奉還-討回公道還是
Tech-Writing #筆記 11/
Self-Editing - Debug //
4. 換位思考,想想會看自己文章的人。會不會 PM 來看,不太清楚你在文中提到自己組內才有在用的 Design Pattern 是什麼?
5. 把寫的文章念出來看看。可以容易找出文章中的 Bug。像是句子太長、奇怪的片語、怪怪的地方。不想自己念,也可以用 Screen Reader 軟體自動幫你念。 (黃色小鴨版的寫作 Debug ?)
6. 一個小時後再回來看看自己寫的鬼東西,可以用比較新鮮的觀點來除錯。 (Blame下去看看寫這爛 Code 的人到底是誰!?原來是我自己。)
7. 換一個寫作的工作情境/場景。來去審視自己的文章。換換字體顏色大小?印出來看看?
8. 找一個辦公室的路人同事幫看。最好是他能知道你的寫作風格是哪一種。 (Peer Review)
Tech-Writing #筆記 10/
Self-Editing - Style //
1. 試着找一個寫作的風格去遵循。跟寫 Code 一樣。找一個屬於“寫作”的 //Coding Guideline//。
2. 如果你是在某個 OpenSource 案子底下,或是在有自己寫作風格的公司底下寫文件。最好就是遵循該組織的風格。跟 Naming Convension 一樣,沒有對錯,只有一致。
3. 都找不到的話,試試看 Google 的 // Google Developer Documentation Style Guide //
https://developers.google.com/style
Tech-Writing #筆記 10/
Self-Editing - Style //
1. 試着找一個寫作的風格去遵循。跟寫 Code 一樣。找一個屬於“寫作”的 //Coding Guideline//。
2. 如果你是在某個 OpenSource 案子底下,或是在有自己寫作風格的公司底下寫文件。最好就是遵循該組織的風格。跟 Naming Convension 一樣,沒有對錯,只有一致。
3. 都找不到的話,試試看 Google 的 // Google Developer Documentation Style Guide //
https://developers.google.com/style
Tech-Writing Course #筆記 9/
Documents
1. 定義好你文件的範圍。
《讓 Lomo 的開心的365招》
- 如何讓 Lomo 在身心靈上感到滿意。
2. 如果覺得讀者會以爲你的文件,也會提到什麼範圍,可能要特別指出 "不會包括的範圍"。
《讓 Lomo 的開心的365招》
- 本手冊不包含Lomo對貓草8種可愛反應
3. 一大包文件很恐怖,試着在開頭直接把總結/Summary 寫出來,列出你文件的幾項關鍵特點。
4. 寫文件時,回答以下問題
a. TA是誰?
b. 你的TA讀這個文件的目標是什麼?
c. 你的讀者在讀這份文件時,已經知道什麼?
d. 你的讀者在讀完這份文件之後,能夠做些什麼?
5. 組織你整個文件的段落 (能夠寫 Outline 的意思)
Tech-Writing Course #筆記 8/
Audience
1. 找到你的 TA 讀者 (Target Audience)。想清楚對象是誰,來決定整個文章用到的知識背景、字彙。
2. 對象是軟體工程師的話,理論上他/她應該會知道什麼是 Big-O。要介紹AI的內容,對快畢業的大四學生跟剛入學的大一生,準備的內容也會差很多。
3. 列出此篇文章,你預計會讓讀者學到的知識。
- 知道 Lomo 的私房肉泥口味
- 知道如何讓 Lomo 朝你走過來。
- 知道如何讓 Lomo 舉起左右貓掌,跟你握手。
4. 讀者可能不知道你Team的內梗、內部縮寫、或是內部實作。儘可能對新字、新概念,多做解釋來幫助讀者。
5. 想想當初身爲新手的感覺。不是所有人都懂你已經懂得東西。
6. 儘量使用簡單單字。不是所有人的母語是英文。
7. 儘量不要講文化內哏。像是跟外國人使用GG表達完蛋的意思,應該會感到困惑。
Tech-Writing Course #筆記 7/
Paragraphs
1. 段落的第一句話,請直達核心帶到本段落的主角。因爲工程師很忙,沒時間猜整段的重點是什麼。
2. 每一段落討論一個主題。如果段落中有帶到別的主題的句子,請把它移到別段。試着保持整個段落的高凝聚力。(High Cohension)
3. 段落不要太長。超過七句的段落,看起來太硬不好讀。最棒的長度是三到五句。
4. 段落也不要太短。動不動一兩句就分段,會讓文章看起來支離破碎。
5. 一個好的段落要能回答
- What {能告訴讀者什麼?}
- Why {爲什麼這段資訊對讀者很重要?}
- How {讀者要如何利用本段落的資訊?} {讀者如何知道你不是在唬爛?}
Tech-Writing Course #筆記 6/
Lists and tables 2/
5. 試着使用指令式動詞 (Imperative Verb),擺在有序列表項目的開頭:
Lomo 喜歡的套餐如下
a. "摸"一下頭
b. "抓"兩下脖子
c. "雙手拍"屁股連續二十下
d. "摸"兩下頭
6. 如果項目是句子,請在開頭字母大寫,結尾加句點。
如果項目不是句子,開頭字母請小寫,結尾不要加句點。
7. 表格的“直欄"要有有意義的"標頭",不要讓讀者困擾。
8. 表格的 單元(cell) 跟列表一樣,也是要維持平行性。
9. 表格的單元不要放太多字。
10. 表格跟列表的開頭介紹詞,可以擺入 "The following" 來當開場白。
Tech-Writing Course #筆記 5/
Lists and tables 1/
1. 列表分爲有序(numbered)與無序(bulleted)。若是列表項目移動位置,會改變意思的話,就用有序列表;反之則用無序列表。
2. 內嵌式列表(embeded),就是擺在句子中用逗號分隔項目列表。例子: Lomo 喜歡的肉泥有雞肉、蟹肉、鮭魚、鮪魚。
3. 大致上科技資訊不太適合使用 embeded 。儘可能把轉化成有序列表或是無序列表。
Lomo 喜歡的肉泥有:
- 雞肉
- 蟹肉
- 鮭魚
- 鮪魚
4. 保持列表中項目的平行性: 文法、邏輯分類、大小寫、標點符號、詞性都要保持一致。
錯誤示範:
Lomo 喜歡的肉泥有:
- 雞肉 -> 名詞
- 被處理煙燻過的蟹肉 -> 有加形容詞的名詞
- 媽媽從抽屜拿出肉泥 -> 主動句子
- 肉泥被我拿出來 -> 被動句子
Tech-Writing Course #筆記 4/
Short sentences /2
5. 減少使用從屬子句。根據一個句子一個想法,如果從屬子句是在延伸"主句"的想法,那就可以保留。如果是已經在描述別的意思,就把它拆解會比較好。
xx: Lomo is a cat that is big and white, which likes chase Nini all the time.
oo: 又大又白是在加強 Lomo 這隻貓的介紹。很愛追Nini是別的事情,可以分開成另一個句子。
6. 區分 which 跟 that 的差別。如果你的句子講到子句前會緩一下,那就用 which;如果子句講過去非常順不會停,通常會使用 that 來連接。
Tech-Writing Course #筆記 3/
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
Tech-Writing Course #筆記 2/
Clear sentences
1. 動詞是句子的核心元件。挑選更多樣性、更精確、更強烈的動詞,來讓你的句子有簡潔又有力量。
2. 弱的動詞像是"發生惹"(happen/occur)、"是..."(be動詞)。想辦法用更明確的動詞來替代。
xx 當Lomo肚子餓惹,就有一個神祕的聲響[發生],
oo 改成:Lomo的肚子餓[發出]神祕的聲響。
xx Lomo is very careful to ensure Nini is not that.
oo 改成: Lomo carefully ensure Nini is not that.
4. 句子中用到很多弱/通用動詞,通常是一種徵兆。表示是你可能不經意地用了被動式,或是用詞不夠精準,或是少了句子的主詞。
5. 絕大部分的 There is/there are 都是冗冗的。試著拿掉它改寫看看,會讓句子更簡潔。
6. 減少使用飄渺的形容詞。RD需要的是精確的描述。
xx: Lomo 睡了靠悲得久才醒來。
oo: 改成 Lomo 比昨天多睡了四個小時才醒來。