moar doco, particulary about Java8