update changelog and fix up some documentation

Signed-off-by: Roy Storey <roy.storey@plantandfood.co.nz>