[dajiaohuang]

Problem and change

Several mapping-driver examples in docs/en/reference/index.rst do not match the public driver contracts:

• JSONFileDriver omits the ClassMetadata import and the required parameter/return types.
• loadMappingFile() decodes the filename instead of reading its contents, and the locator extension is missing its leading dot.
• Examples instantiate the ClassMetadata interface instead of using the mapper's metadata implementation.
• The static-driver example calls $phpDriver rather than $staticPHPDriver and describes file loading rather than User::loadMetadata() dispatch.

Correct the examples and explicitly state that the mapper supplies $classMetadata. This is one documentation page only; no library API, implementation or dependencies change.

Validation

Existing unchanged-base/candidate evidence is reused: PHP 8.3.6 reproduces the original declaration incompatibility; the corrected JSON driver and real FileDriver/locator consumer pass, including filename decoding and extension behavior. Reflection/registry/driver/decorator checks, the real metadata-factory checks and lint of all 36 production PHP files also passed.

Full PHPUnit/PHPStan/PHPCS and documentation generation were not run. The documentation workflow needs PHP 8.4 and a Composer-provided docs builder, absent from the local environment; the exercised library APIs support PHP 8.3. No dependency installation or real ORM/database integration was performed. Normal platform PR checks may run; no CI pass or merge-readiness claim is made.

[GromNaN]

Thank you @dajiaohuang

[greg0ire]

Thanks @dajiaohuang !