i improved the doc, hope that helps: https://github.com/doctrine/phpcr-odm/commit/13c3685e7150b61297ea578be555b79b35511839