The problem is that there a TT least three different standards. @dbu 
says that you preferred directory_file_section_name - by contrast I 
prefer directory_file_sectionname (to differentiate the section from the 
path) but in any case, cash I propose we standardise the docs and 
resolve this forever? :)

On 2013-09-30 22:08, Wouter J wrote:
> In reference/configuration/menu-bundle.rst:
> 
>> +``composer.json`` require section, the menu documents are exposed
> in the
>> +SonataDoctrinePhpcrAdminBundle. For instructions on how to
> configure this
>> +Bundle see :doc:`doctrine_phpcr_admin`.
>> +
>> +By default, ``use_sonata_admin`` is automatically set based on
> whether
>> +SonataDoctrinePhpcrAdminBundle is available, but you can explicitly
> disable it
>> +to not have it even if sonata is enabled, or explicitly enable to
> get an error
>> +if Sonata becomes unavailable.
>> +
>> +By default, menu nodes that have neither the URI nor the routeName
> field set
>> +and no route can be generated from the linked content are skipped
> by the
>> +``ContentAwareFactory``. This also leads to their descendants not
> showing up.
>> +If you want to generate menu items without a link instead, set the
>> +``allow_empty_items`` parameter to true to make the menu items show
> up as
>> +plain text instead.
>> +
> 
> please use the same format as the other references
> 
> --
> Reply to this email directly or view it on GitHub [1].
> 
> Links:
> ------
> [1] 
> https://github.com/symfony-cmf/symfony-cmf-docs/pull/183/files#r6671316