人気の API ／フレームワークを作るための 39 カ条が公開されています。やはり基本は「シンプル」そして「わかりやすい」ですね。

本文 関数名や変数名にはわかりやすい名前を付けましょう。*1 わかりやすい名前を付けると、以下の利点があります。 コードの意味が一目でわかるようになる メンテナンスがしやすくなる 再利用がしやすくなる なお、わかりやすい名前を付けることで生じる欠…

volatile は正しい使い方をしましょう。 Java の volatile は、 Java の理論と実践: volatile を扱うが詳しいです。