API の設計方針とツール

Tag Archives: refactoring

Trema の API をどのように決めているか、舞台裏を紹介します。Trema API の唯一の設計方針は「短く簡潔に書けるかどうか」ですが、具体的にはこんな方法で設計しています。

ごちゃごちゃとしたコードは読みにくく、バグを発見しづらいものです。ふつう、コードというものは書くよりも読む回数の方が圧倒的に多いので、ごちゃごちゃとした部分を減らすことで「読みやすさ」を最適化しなければなりません。読みやすいコードほどバグを発見しやすく、機能を付け加えるのも簡単です。

Tagged flog, refactoring

コードのコピペには良いコピペと悪いコピペがあります。オープンソースのコードから使えそうなところを改変して取り込むのは良いコピペ (ライセンスとコピーライトの確認も忘れずに)。一つのソースツリーの中に同じコード断片がたくさんあるのが悪いコピペ。

Tagged flay, refactoring