Bundle extension documentation

[cordoval]

On this page here
http://symfony.com/doc/current/cookbook/bundles/extension.html

i read

If you follow the naming conventions laid out above, then the load() method of your extension code is always called as long as your bundle is registered in the Kernel. In other words, even if the user does not provide any configuration (i.e. the acme_hello entry doesn't even appear), the load() method will be called and passed an empty $configs array. You can still provide some sensible defaults for your bundle if you want.

and

Additionally, the load() method of your extension will only be called if the user specifies the acme_hello alias in at least one configuration file. Once again, this is because the Extension class doesn't follow the standards set out above, so nothing happens automatically.

I might be pulling things out of context, but it is confusing to understand whether your configuration will be loaded when you don't put acme_hello in your config.

/cc @flip111

[wouterj]

The first quote is from a section called "Creating an Extension Class". In that section, we are talking about creating an Extension class that follows the conventions. In that case it's always loaded (when the bundle is registered). From the quote: "If you follow the naming conventions laid out above, then the load() method of your extension code is always called as long as your bundle is registered in the Kernel."

The second quote is from a section called "Extension Conventions". It's placed before an example showing what to do when your Extension class does not follow the conventions. In that case, the class isn't loaded. From the quote: "the load() method of your extension will only be called if the user specifies the acme_hello alias in at least one configuration file. Once again, this is because the Extension class doesn't follow the standards set out above, so nothing happens automatically."

I don't see anything wrong here. We just talk about 2 different cases: following the conventions or not following them. In both cases, something else will happen.

So I'm going to close this issue, as there is nothing wrong with the docs and I can't see a way how we can rewrite it, as it is just telling what it needs to tell. However, feel free to comment on this more or even create a PR making the stuff easier to understand.