documentation update with messaging