[donatj]

The README can drift from the source and Composer requirements because its generator is not installed or checked in continuous integration.

Add MDDoc as a development dependency and run its dry run in the PHP 8.5 job. Update the autoloader configuration and regenerate the README. Read Slevomat's installed README when generating links, so the check does not depend on a live copy of another branch.

Validation: generated the README and ran the MDDoc dry run. Confirmed it rejects a stale README. Ran make test and Composer validation on PHP 8.5.

[Copilot]

🟢 Approval recommended

No active review issues block the changes adding a CI check for generated README consistency.

No open issues 🎉

What changed in this PR

Adds a CI check to keep the generated README aligned with the coding standard’s source and Composer requirements.

Changes:

• Adds MDDoc as a development dependency, configures Composer autoloading, and runs its dry run in the PHP 8.5 CI job.
• Uses the installed Slevomat README for link generation instead of fetching the upstream branch.
• Regenerates the README with updated requirements and corrected code examples.

File	Description
tools/​inherited-rules.php	Reads the installed Slevomat README and reports read failures.
README.md	Updates requirements and fixes example syntax.
composer.json	Adds the MDDoc development dependency.
.mddoc.xml	Switches documentation generation to Composer autoloading.
.github/​workflows/​ci.yml	Checks generated documentation on PHP 8.5.

_{Review effort: Balanced}