Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Updated the Quick Tour to the latest changes introduced by Symfony #5631

Closed
wants to merge 2 commits into from

Conversation

javiereguiluz
Copy link
Member

Q A
Doc fix? yes
New docs? no
Applies to all
Fixed tickets -

This PR complements the pending PR #5497.

@@ -155,11 +155,12 @@ because that will be explained in the next section)::

use Sensio\Bundle\FrameworkExtraBundle\Configuration\Route;
use Symfony\Bundle\FrameworkBundle\Controller\Controller;
use Symfony\Component\HttpFoundation\Request;
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is not needed.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You are right. I've added it to make it identical to the controller they will see. We decided to add the Request import to make it easier for newcomers: https://github.com/symfony/symfony-standard/blob/2.8/src/AppBundle/Controller/DefaultController.php#L7

However, the content of the indexAction() is not the same as in the symfony-standard. I did this because in this case it's more confusing than useful.

In any case, let me know what you think about this and I'll make the changes you say. Thanks.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I am not sure if it makes things easier to understand for newcomers when they see a use statement for a class that is not used anywhere. It could give them the feeling that simply adding the use statement triggers some magic. However, let's see what Ryan and Wouter think about it.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I agree with @xabbuh here. I can see why it's usefull at the code side, I think it's confusion when doing it in the docs.

defined in the ``src/AppBundle/Controller/DefaultController.php`` file and rendered
the ``app/Resources/views/default/index.html.twig`` template. In the following
sections you'll learn in detail the inner workings of Symfony controllers, routes
and templates.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The new word wrapping in this paragraph is incorrect (the previous word wrapping was done by docbot)

@javiereguiluz
Copy link
Member Author

I've changed everything you asked me to. This is ready for the final review. Thanks!

@xabbuh
Copy link
Member

xabbuh commented Sep 2, 2015

👍

1 similar comment
@wouterj
Copy link
Member

wouterj commented Sep 5, 2015

👍

wouterj added a commit that referenced this pull request Sep 5, 2015
… by Symfony (javiereguiluz)

This PR was squashed before being merged into the 2.3 branch (closes #5631).

Discussion
----------

Updated the Quick Tour to the latest changes introduced by Symfony

| Q             | A
| ------------- | ---
| Doc fix?      | yes
| New docs?     | no
| Applies to    | all
| Fixed tickets | -

This PR complements the pending PR #5497.

Commits
-------

45b3781 Updated the Quick Tour to the latest changes introduced by Symfony
@wouterj wouterj closed this Sep 5, 2015
@DQNEO
Copy link
Contributor

DQNEO commented Sep 5, 2015

👍

@javiereguiluz javiereguiluz deleted the update_quick_tour branch May 24, 2018 16:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants