docs: make core messages accurate and documented
10 files changed