Simplified the framework configuration reference

[javiereguiluz]

I propose two main changes:

• Show how can users display the default config and their own config.
• Remove the dump of the default config values.

I never liked the config dump because in my opinion:

• It simply adds "noise" and doesn't explain anything
• It's hard to maintain it updated
• The same can easily be achieved with a dedicated console command
• Removing it will simplify the work of doc maintainers and it'll reduce the merge conflicts
• These references are very useful for the config option descriptions, not for just listing those options

Thoughts? Thanks!

PS: if you agree, I'll update the rest of the references.

[ogizanagi]

I actually like having the full configuration reference. It gives a big picture of the available features, its options and defaults, without having to boot a symfony app and using the config:dump-reference command (which sometimes may not work because you made a mistake in this very same configuration).

But that's only my opinion. I kind of understand the "It's hard to maintain it updated" argument, because we don't think to update it often enough and it shouldn't be updated manually, but it actually only requires pasting the result of the config:dump-reference command.

[javiereguiluz]

I've reverted the most controversial changes in this PR, so now it just proposes to reword the intro and mention the debug:config and the config:dump-reference commands.

[HeahDude]

Great addition! 👍

[wouterj]

Should be php bin/console ... (same below) to be Windows compatible

[weaverryan]

I do like listing the config:dump command (btw, I usually shorten it - config:dump is so much nicer) on each reference page.

[weaverryan]

Do you not like the ("framework") part? I always like it... because what the user really thinks is "what things can I put under this framework key?)

[javiereguiluz]

I made all the asked changes. Ready to merge it. Thanks.

[weaverryan]

Thanks Javier!