improving javadoc, adding links to external apis