命名:新しい版のインターフェースに付ける名前

問題

インターフェースはほぼ同じだが、新しい版では異なる入出力になっているような場合、単純に同じ名前を付けるわけにもいかず、かといって違う名前を付けるにも困ることがある。

対応案

xxxNew

新しいことを示す New を付ける。

素朴だが、次に刷新するときに困る。

xxx2

バージョン番号方式

この番号の意味するところが分かりづらい。

xxxV2

バージョンであることを明確にする

ver まで書くと冗長

Web API の URL では以下のようにしていることがある。

/.../v2/xxx