#143 improved API documentation in javadoc
javadoc in API for use case