re-write of documentation