[PLAT-3941] Tidy up Java docs