updating-internal-docs

Review internal documentation (*.md files) against the current codebase state and propose updates for outdated or incorrect information.