>> 首頁

屬於自己的 changelog

第 7 期 | 發布於 2022-03-27 | 最後更新時間 2022-03-27

兩週前在電子報裡分享了來自科技創業週報星箭廣播團隊寫的關於 changelog 的兩篇文章,當時這個想法就在心中悄悄地萌芽。

這兩天再回頭看了一下兩篇文,認真的做了筆記,也有更多想法冒出來,就來分享一下。

如果說產品的 changelog 是為了紀錄與呈現各版本之間的演進差異,讓使用者明瞭產品改了什麼以及為什麼要改,也讓開發者能夠對於產品有共同記憶,在一樣的基礎上溝通與開發。

那屬於個人的 changelog 或許也可以如法炮製,讓自己清楚明瞭不同時間點的自己有了哪些變化以及為什麼會產生這些變化

而這份 changelog 一樣可以分成對內以及對外的兩個版本,對內的是只有自己才看得到的,各個細節的差異變化,目的是讓自己能夠。對外的則是展現「別人可能有興趣」的內容。

這樣的個人 changelog 上面該紀錄哪些內容呢?目前我只有打算先紀錄給自己看的「對內」版本,可能會分成三種類別:主版號、次版號、修訂號。

主版號紀錄那些自己個人、生活、或工作上的重大變化,我的想像是,那些「你會跟幾年不見的朋友聚會時,最一開始聊的話題」,就是屬於這類的內容。

次版號紀錄的是自己新增或優化的功能,也就是那些自己新學到的技能、新養成的習慣、或者新嘗試並且真的成為自己一部分的興趣等等。

修訂號則放上自己戒除的壞習慣、被提醒改進且有嘗試改進的缺失、或者是自己不再做的是、不再用的東西等等。

目前只是先想想而已,才剛記下第一筆紀錄,之後有心得再來分享。

不過也因為這個契機,當我在查看有沒有人這樣分享、或者是有沒有相關的產品就在做這件事時,就找到了 Github 的產品設計師 Brian Lovin 曾經寫過的Make a personal changelog,以及他分享的新創服務Polywork,雖然我註冊申請了,但必須要排 waitlist ,所以還沒辦法嘗試。

我很喜歡 Lovin 在這篇文裡面寫的一段話:

Could the personal changelog be a solution? It can sit at the right fidelity where people want to update it regularly, but not so often that it competes with a Twitter feed. But it’s updated often enough, with the flexibility to represent all kinds of activities, that it can become a true reflection of someone's professional and creative momentum over time.

這段話想像的「changelog 理想更新頻率」跟我的想像好像,而且 Lovin 的個人網站也很讚,推薦啦全部都推薦啦!


Workflow

今天順著上週介紹的閱讀輸入 workflow,繼續來介紹下一階段的資訊處理 workflow,或者說我怎麼將一篇文章的畫線與速記,處理製作成 Literature notes 以及 Permanent notes。

這樣的處理流程也是最近才慢慢固定下來的,但運作了一陣子後覺得非常流暢,簡單來說步驟如下:

先閱讀、畫線、註記

  • 首先我已經閱讀完一些文章,上面會有著我用 Curius 畫線的段落,有些段落上面也會有一些閱讀時寫下的速記,包含我自己的換句話說、我自己的疑惑、或者是靈感。
  • 讀完一篇文章後,我會在 Curius 上面把這篇文章標註,可能有「單純讀就好」、「待做筆記」、「做完筆記」這幾類。
  • 每天晚上或週末比較有空的時間,就挑那些「待做筆記」的文,打開 Logseq ,在上面開始寫 Literature notes。

開始撰寫 Literature notes

  • 撰寫的方式,可以參考正確使用卡片盒筆記法(Zettelkasten)的六個關鍵步驟 這篇好文的寫法,重點是把自己有感的段落,用自己的話條列式記下。(記得,不要照抄,也不要複製貼上)
  • 這邊的關鍵在於「自己的共鳴」跟「自己的話」,一開始會不太習慣,但慢慢練習就會越來越熟悉。
  • 因為這件事相對花時間與精力,所以在前段閱讀時就要控管好,找出真正想寫文獻筆記的好文去寫就好,其他可以看過、隨意寫一些註記或閃念筆記(fleet notes)就好。
  • 另一個訣竅是,不要怕竄改作者的意思,總之用自己的話寫就對了,反正 Literature notes 沒有要輸出用,輸出時的嚴謹性可以輸出時再控管處理。
  • 當我寫完 Literature notes 時,會趁著記憶猶新,從剛剛寫完的筆記裡面,挑一兩個疑問或論點出來發展成自己的 Permanent notes。

開始撰寫 Permanent notes

  • 跟 Literature notes 不同的地方在於, Permanent notes 的重點在於發展論點,並且用任何人都能理解的方式撰寫。論點的內容著重在自己的想法與靈感。
  • 舉例來說,我在看上面那篇文並撰寫 Literature notes 時就寫下了「我的疑問:在數位工具中,索引編號本身有意義嗎?」所以我就馬上把這段文字當成是一則永久筆記的標題,開始寫下我自己的想法。寫完之後,就幫這兩則筆記之間建立關聯性。
  • 一則一則 Permanent notes 寫好後,我會再把他們從 Logseq 移轉到 Heptabase ,處理不同永久筆記之間的連接以及索引,這部分的細節就之後再來分享吧!

推薦文章

本週只推薦一篇寫 Wordle 好在哪的文 Wordle is pretty damn smart in many subtle ways

我自己到現在跟女友每天都還是會玩 Wordle ,本篇作者總結了幾個他覺得 Wordle 設計的好的機制,並且提到,一般工程師跟跟資深工程師的差異不在於他們寫了哪些 code ,而在於他們不寫哪些 code 。我不是工程師,無法判別這句話描述的是否精準,但我個人很喜歡 Wordle 這種「節制功能」的產品。


新東西分享

本週沒有實際使用什麼有趣的新東西,倒是有發現一個感覺很酷的 “Storytelling Tool” - tome,看起來是個很容易把各種地方的內容都整合起來呈現的工具,以我自己來說,就有想到可以改善目前工作流程的用法,但填了 email 後也還沒收到試用的邀請,無法分享心得。

如果有類似,但已經相對成熟的產品,也歡迎分享推薦給我,感謝!


如果你對於本站或本文有任何想討論或分享的,歡迎來信到:mimir@hey.com 找我聊聊!