add javadoc and update main readme about response
refactor response wrapper