wip-java-api-fix: Documentation update for new Java API