more docs tidy-up