Гайд по бинарной совместимости API для Java. Некоторые идеи по эволюции API (особенно из приемчиков, как поступать в трудных ситуациях) применимы и для других API (например, REST).