Update the Getting Started tutorial to follow the Symfony Best Practices #4360
Comments
14 tasks
|
@javierguiluz If you want to do all the work, I won't mind. :) |
weaverryan
added a commit
that referenced
this issue
Nov 13, 2014
This PR was submitted for the master branch but it was merged into the 2.3 branch instead (closes #4374). Discussion ---------- [WCM] Revamped the Quick Start tutorial | Q | A | ------------- | --- | Doc fix? | yes | New docs? | yes | Applies to | master (2.6+) | Fixed tickets | #4360 This is a total revamp of the Quick Start tutorial. Following the recent trend in the Symfony world, everything is simpler now. The main changes are: * The tutorial requires PHP 5.4 because this way everything is simpler. By the way, PHP 5.3 is unsupported since August 2014 and it's extremely dangerous to keep using it. * We use the `AppBundle` and the other changes that will introduce the standard edition soon. There are some pending PR. * Some advanced features, such as HTTP caching, have been removed. This tutorial is aimed for the total newcomer and it doesn't make sense to confuse him/her with things not needed at first. There is one important thing missing: * The section about installing Symfony is pending of the new Symfony installer, specially for Windows users. And one last comment: * Someone, which I cannot remember, commented a few weeks ago that maybe we should get rid of the different versions of this tutorial. I agree that the tutorial aimed for newcomers should be unique to avoid confusions and it should always explain the latest and greatest Symfony features. I've created this PR against the master branch for that reason and I ask the doc managers (@weaverryan, @wouterj and @xabbuh) to think about removing all the previous versions of this tutorial. Commits ------- 811f6e8 Included a bunch of fixes suggested by the awesome Symfony doc reviewers 940924c Added a bunch of fixes suggested by @xabbuh 6105acb Fixed a RST formatting issue baf4b9b Revamped the Quick Start tutorial
|
Closing this issue because the related PR is merged and this is now fixed. |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
There are some pending issues to be merged in the
symfony/symfony-standardrepo related to the new Symfony best practices. Basically we'll provide anAppBundlealready created and aservices.ymlconfiguration file.The tutorial aimed at newcomers should use the existing
AppBundleand the already created config files. This issue is a reminder to update that tutorial. If the doc managers agree, I'd like to take care of this issue myself.The text was updated successfully, but these errors were encountered: