more words on entities and documentation accuracy