👀 @BabylonLabs_io のドキュメントを読んで、仕組みがどう動いているかをそのまま理解できるだけだと思っていたんです。
でも、いろいろなコメント(雑多な所見)に出くわしてしまって……そして、いつの間にかその小さなメモがいちばん面白い部分になってました。😂
たとえば、「とりあえず今は」みたいに書かれたコメントって……整理されたドキュメントなんかより、システムのことをよく暴いてくれるんですよね。
この手の監査が実際に浮き彫りにするのはこんな感じです:
隠れた技術的負債 「あとで直すTODO」があって、結局直されなかったコメント。誰かが気づいて、誰かが次に進んだ。
保守性の懸念 開発者が将来の自分(あるいは未来の“誰か”)に向けて残す、脆かったり触りづらかったりする部分のメモ。
将来のリスクの兆候 たまたま今だけ成立している前提を示す、うっかりしたコメント。その後静かに問題化するやつ。
アーキテクチャの摩擦ポイント コンポーネント同士がきれいに噛み合っていない場所で、誰かが修正の代わりにコメントを残した。
つまり:雑多なものに見えるけど、実は全然雑じゃない。誰も読まない工学の日記なんです。
#baby $BABY
でも、いろいろなコメント(雑多な所見)に出くわしてしまって……そして、いつの間にかその小さなメモがいちばん面白い部分になってました。😂
たとえば、「とりあえず今は」みたいに書かれたコメントって……整理されたドキュメントなんかより、システムのことをよく暴いてくれるんですよね。
この手の監査が実際に浮き彫りにするのはこんな感じです:
隠れた技術的負債 「あとで直すTODO」があって、結局直されなかったコメント。誰かが気づいて、誰かが次に進んだ。
保守性の懸念 開発者が将来の自分(あるいは未来の“誰か”)に向けて残す、脆かったり触りづらかったりする部分のメモ。
将来のリスクの兆候 たまたま今だけ成立している前提を示す、うっかりしたコメント。その後静かに問題化するやつ。
アーキテクチャの摩擦ポイント コンポーネント同士がきれいに噛み合っていない場所で、誰かが修正の代わりにコメントを残した。
つまり:雑多なものに見えるけど、実は全然雑じゃない。誰も読まない工学の日記なんです。
#baby $BABY