some tidying to docs