Symfony 3 will be released at the end of this year. Fortunately, most of the Symfony 2 documentation will be still valid and we'll only have to remove some outdated sections.

However, we should probably create new documents to prepare the transition from Symfony 2 to Symfony 3. For example, today someone asked me via Twitter if we had an article explaining the new Symfony 3 directory structure.

Would it be enough to create one article explaining how to upgrade applications from Symfony 2 to 3? Would we need to create several articles in a new "Symfony 3" cookbook section? Let's discuss about it and prepare an actionable roadmap.