update/optimise docs