Если по минимуму усилий, то можно поддерживать API комментируя только публичные методы (а-ля
https://ru.wikipedia.org/wiki/Javadoc, https://ru.wikipedia.org/wiki/JSDoc и тому подобное) и впоследствии генерируя документацию.
Легкость подхода в том, что меняя метод ты тут же в коде видишь его описание и меняешь его при необходимости.
