Ok, that should fix those points.

Thanks for the comments, guys. These commits should resolve those issues.

Hi John!

You've done some really really nice work here - clearly explaining (probably more clearly than anywhere else in the docs) the purpose of environments, the configuration files, and the front controllers in a very calm way.

Unfortunately, I'm going to have to make your life a bit more difficult, and I hope you'll help me :). The problem is that these "Quick Tour" entries are about teaching of course, but they are even more about getting people excited to use Symfony so that they'll continue trying things and read the book. So it's important to keep these articles short and exciting. We've already made this entry a bit longer than it used to be, and if anything, I'd like to make it shorter.

But as I already mentioned, some of your descriptions here are really nice and I don't want to lose them - I just don't think that this is the correct place to make these changes. I propose:

1. We remove the new "Environments" section and perhaps move some of those details down into the "Working with Environments" section

2. Remove the new "The Web Debug Toolbar and Profiler" section and put those details back into the "Working with Environments" section. You've laid things out more logically and explained things in more detail. But now the user needs to read into some pretty technical details about environments before seeing the very-exciting web debug toolbar.

3. Move the really nice explanation of environments (i.e. the "Environments" section and other things you added to "Working with Environments", like talking about the front controllers) to another location. I think the natural best place is probably the "page_creation" chapter. In fact, it's very important in that chapter that a new user can read and code along from start to finish and understand what's going on (e.g. what is this "app_dev.php" file? etc).

Let me know what you think, and if possible (and even better), if you can make these changes. I definitely don't want to lose your nice descriptions, so if you're unable to make these changes, I'll cherry-pick them into other places.

Thanks!

Ok, I'll see what I can do about that later this week.

This was originally based off the 2.0 branch. Since it's been awhile, do we want to keep this based on 2.0, or do you want me to rebase this off 2.1 or 2.2 (or even 2.3)?

please base it on 2.2

Closing this -#2823 has already been merged :)