小周媽的旅行與生活

這個詞經常出現在會議記錄跟 email, 通常一開始劈頭就放 tl;dr 為開場白. tl;dr 是 too long didn’t read 的縮寫, 但是到底放在第一行是要幹嘛? 是叫讀者直接放棄不要看了嗎?

在之前的文章, 小周媽有分享過, 我的 team 有開源程式碼. 開源的團隊, 需要非常強的 documentation 支援, 畢竟沒有好的技術文件, 別人無法快速上手使用你的東西. 我們的 team 雖然有 technical writer (專門寫技術文件的組員), 但總有一些不算完美的地方, 或是解釋不清的地方, 所以有時候會接到軟體工程師送訊息過來問問題:

首先對方說這個問題也有在 dev-support channel 提過 (cross-post 是重複 po 文的意思). 然後他提供了一個 link, 那個 link 就是連到他目前的程式碼. 很多時候直接提供程式碼我們比較好幫忙, 但是直接看程式碼的缺點是要摸索一陣才知道他想要幹嘛, 所以他馬上在 link 下面說:

“簡單一句: 當我用你的 framework, 我怎麼知道接上後端的搜尋結果已經出來了呢?”

tl;dr 這個詞, 後面接的就是總結的部分, 讓那些想要一句話就了解狀況的人可以看 tl;dr 就好. 現在真相大白了吧~ 會議記錄跟 email 如果落落長, 我可能會在開頭放 tl;dr 先來總結一句, 免得讀者一看 20 頁的文件就直接跳過了 😂 這個詞有時候開會或上台演說也會用到. 通常是直接說:

“Too long didn’t read, we need to get this ready by Friday.”

這句話就是”簡單說, 我們週五之前要弄好.” 有的時候是直接念出 T-L-D-R 四個字母, 這樣大家也會知道你是 too long didn’t read 的意思:

“I guess T-L-D-R, we need to get this ready by Friday.”

[同場加映]

今天使用的大頭照是 John Backus, 來看一下這位先生是誰.