improve - api interface javadoc