Update Quick Tour for Removal of Welcome Page in 2.7

[BT643]

It seems the "Welcome!" page has been removed as of 2.7 so the quick tour documentation is now misleading / wrong.

https://symfony.com/doc/current/quick_tour/the_big_picture.html#running-symfony

It tells you to go to http://localhost:8000 to see the welcome page but this just brings up an error as there is now no route defined for /.

I was going to update the documentation but wasn't sure what to put there instead? Just tell the user to go straight to /app/example and see the "Homepage." text I guess would be the best option?

[michaelperrin]

This can be indeed misleading for new comers. The whole Quick Tour should be rewritten with either a simple step by step new app (creating the controller / routing / template) or with the new demo app (http://symfony.com/blog/introducing-the-symfony-demo-application).

I would prefer the first solution, as Symfony is installed by developers who want to start a new app and see how things work.

[cuthbert19]

I am indeed a newcomer and I was at first very disappointed, while following the quick tour, of not being able to get it to work right after installation. I second michaelperrin proposal, the demo application seems to me as being too complex for a quick tour, while I appreciated the "10 minutes by 10 minutes" lesson of the current approach.

[wouterj]

#5416 is now merged, which fixes the URL. The screenshot has already been updated in another PR. This means that this issue is now completely fixed.

Rewriting the complete Quick Tour, now we got a demo application, is a very good question. We were discussing this internally, but I don't know about the current state of this. Anyway, it's better to have a dedicated issue for this :)

[xabbuh]

It looks like the changes from #5400 and #5416 are not sufficient enough. Firstly, the changes were only merged in the 2.7 branch while the Symfony Standard Edition has also been updated for older maintained versions. Secondly, there were some other wrong URL and text references. I proposed updates for these things in #5461.

[BT643]

There's an issue opened on StackOverflow as little as 9 hours ago which show this is still an "issue" also:

http://stackoverflow.com/questions/31227664/installing-symfony-2-on-windows

[xabbuh]

@BT643 These issue would be tackled by #5461, right?

[BT643]

@xabbuh It would certainly help, although I imagine there would still be some people who would start the built in server from the console which tells you to visit / and wonder why they're getting an "error page".

If that is all properly explained in the quick tour it should resolve it.

[xabbuh]

@BT643 Do you have an idea how we could make this more clear?