[[Evergreen Notes]]を5分でプレゼンするためのメモ。 ## [[Evergreen Notes]]とは https://notes.andymatuschak.org/Evergreen_notes - プロジェクトなどのドキュメントを、時間と共に蓄積/進化/貢献するようにするための執筆/整理術 - [[👤Andy Matuschak]]氏が提唱 ### 注意 - 本発表の表現は引用文を除き、[[📕tadashi-aikawa]]の言葉である - 場合によっては原文とニュアンスが異なる可能性がある ### 背景にある課題 - ほとんどの人は一時的なメモしかとらない - それらは使い捨て、場合によってはノイズにすらなりうる - 戦略的にメモを蓄積することで、これらの課題を回避できる ### つまり 各々が思い思いに[[Confluence]]のページをどんどん追加していったときどうなるか? ということ。 ## [[Evergreen Notes]] 5つの原則 1. [[Evergreen Notes]]はアトミックであるべき 2. [[Evergreen Notes]]はコンセプト指向であるべき 3. [[Evergreen Notes]]は密にリンクする必要がある 4. [[Evergreen Notes]]は階層的分類法より連想オントロジーを好む 5. ~~聴衆を無視して、デフォルトで自分用にメモを書く~~ ## [[Evergreen Notes]]はアトミックであるべき https://notes.andymatuschak.org/z4Rrmh17vMBbauEGnFPTZSK3UmdsGExLRfZz1 ### アトミックとは? - 単体で意味を持つ最小単位 (タイトル含む) - 1つのノートで完結できる - [[アトミックノート]]とも呼ばれる ### [[アトミックノート]]の例 ``` # みみぞう みみぞうとは[[tadashi-aikawa]]が所持するフクロウのぬいぐるみである。なお、自席にあるぬいぐるみは妹の[[みみこ]]なのでお間違いなきよう...。 ``` ``` # tadashi-aikawa 地球に生息するエンジニア。 ``` ``` # みみこ [[tadashi-aikawa]]が所持するフクロウのぬいぐるみ。[[みみぞう]]の妹。 ``` ### アトミックではないノートの例 ``` # みみぞう みみぞうとはtadashi-aikawaが所持するフクロウのぬいぐるみである。 ## tadashi-aikawa 地球に生息するエンジニア ## みみこ tadashi-aikawaの自席にあるぬいぐるみ。みみぞうの妹。 ``` ### ソフトウェアエンジニアリングにたとえると 関数やモジュールのようなもの。エンジニアリングと同じ思想がドキュメンテーションでも利用でき、逆もしかりである。 つまり、大きく過ぎても小さすぎてもいけない。ちょうどいいバランスが大事。 ## [[Evergreen Notes]]はコンセプト指向であるべき https://notes.andymatuschak.org/z6bci25mVUBNFdVWSrQNKr6u7AZ1jFzfTVbMF ### コンセプト指向とは - 概念を中心にノートを作成していく手法 - ノート同士のつながりを発見できる ### コンセプト指向ではないノートの取り方 ``` # Aさんの話 - 早寝早起きが健康の秘訣 - 嫌なことほど率先してやれ ``` ``` # Bさんの話 - 夜遅くまで残らず早く帰れ - 市場価値は需要と供給で決まる ``` ### コンセプト指向なノートの取り方 ``` # Aさんの話 - 早寝早起きが成功の秘訣 - [[早朝が一番仕事が進む]] - 早く起きるために早く寝る - 嫌なことほど率先してやれ - [[市場価値は需要と供給で決まる]]から、自身の価値が高まりやすくなる ``` ``` # Bさんの話 - 夜遅くまで残らず早く帰れ - 夜は作業効率が悪い - つまり、[[早朝が一番仕事が進む]]ので早朝やれということ - [[市場価値は需要と供給で決まる]] ``` ``` # 早朝が一番仕事が進む - 邪魔が入りにくく、心身が消耗していないので (睡眠時間が確保できていれば) ``` ``` # 市場価値は需要と供給で決まる - 人気のない仕事は誰もやりたがらないから、倍率も低く給料も上がりやすい(かも) ``` ## [[Evergreen Notes]]は密にリンクする必要がある https://notes.andymatuschak.org/z2HUE4ABbQjUNjrNemvkTCsLa1LPDRuwh1tXC [[#Evergreen Notes はアトミックであるべき]]、[[#Evergreen Notes はコンセプト指向であるべき]]、からリンクが重要であることは分かる。リンクを躊躇せず作ろう。 ## [[Evergreen Notes]]は階層的分類法より連想オントロジーを好む https://notes.andymatuschak.org/z29hLZHiVt7W2uss2uMpSZquAX5T6vaeSF6Cy ディレクトリのように構造化しない。概念は1つの分類にマッチすることは多くなく、大抵の場合は無理やりマッチさせた部分以外が死角になってしまう。 関連にはリンクを使う。 [[Confluence]]の場合はスペースが同じであれば、同名ページを許さないので秩序が保たれる。 ### タグを使わない https://notes.andymatuschak.org/z3MzhvmesiD2htMaEFQJif7gJgyaHAQvKH49Z - タグは情報量が少なすぎるのでかえって混乱を招く - それを承知の上で用途を限定して使うのはアリ ## まとめ 1. [[Evergreen Notes]]はアトミックであるべき 2. [[Evergreen Notes]]はコンセプト指向であるべき 3. [[Evergreen Notes]]は密にリンクする必要がある 4. [[Evergreen Notes]]は階層的分類法より連想オントロジーを好む ### 今すぐにチャレンジ - [[Confluence]] - `Ctrl/Cmd + K`を使おう - 参考スペースを紹介 - ~~[[バックリンク]]未対応なのが非常にいただけない~~ - [[VSCode]] - [[Foam]] - https://github.com/foambubble/foam