polishing the docs