update docs; layout tidy