polishing + java/scala docs