documentation polished