13分で読めます
自分で付けた名前が後で読めないのを防ぐ、判定の問い1つと5つの型
メモや設計書に自分で付けた名前が、数か月後には自分でも読めなくなる。名前の良し悪しを、説明を読まずに初めて読む人が中身の見当をつけられるかの1問で判定し、読めなくなる名前を5つの型に分けた。とくに見落としやすい、記号に置き換えた名前と比喩を組み合わせた名前を、悪い例と良い例で示す。
NamingProductivityTips
TAG
このタグの記事が全2件あります。
メモや設計書に自分で付けた名前が、数か月後には自分でも読めなくなる。名前の良し悪しを、説明を読まずに初めて読む人が中身の見当をつけられるかの1問で判定し、読めなくなる名前を5つの型に分けた。とくに見落としやすい、記号に置き換えた名前と比喩を組み合わせた名前を、悪い例と良い例で示す。
Obsidianのファイル命名をsnake_caseからkebab-caseへ移行する理由と手順。標準としてのkebab-caseの根拠と、段階的な移行ガイドをまとめました。
つくることで、見える景色がある。

