[3.x]: Hide the default section per area with new config parameter

[Havrin]

By adding a new config parameter it is possible to hide the "default" section in your config.

Approach is to not register the RouteDescriber as a tagged service per area.

Fixes: #1458

[GuilhemN]

Thanks a lot for your proposal!

However, I'm not sure this is the correct approach, this means we would no longer leverage php annotations, symfony routes, etc. when using this option and that would be quite confusing (as well as suboptimal) in my opinion.

What do you think about the alternative I suggested in #1458 (comment), about filtering the routes passed to the RouteDescriber depending on the presence of some OA annotations?

[Havrin]

@GuilhemN my idea was to prevent generating those routes so it will be faster. But you are right, there can be side effects.
I will check your comment and change the MR accordingly :)

[Havrin]

@GuilhemN in case the notification slipped through: I changed it like discussed in the Bugticket :) let me know if somethings wrong.

[GuilhemN]

That's great, thank you @Havrin!

[roger-codina]

Hi guys, why this feature is not present in the 4.x versions?

https://github.com/nelmio/NelmioApiDocBundle/blob/v4.6.2/DependencyInjection/Configuration.php#L52

Even the FAQs about 4.x:
https://symfony.com/bundles/NelmioApiDocBundle/4.x/faq.html#disable-default-section
are refering to this feature that was added with this current PR.

Thanks!