8000 Remove block which doesn't make sense after best practices by ifdattic · Pull Request #4929 · symfony/symfony-docs · GitHub
[go: up one dir, main page]

Skip to content

Remove block which doesn't make sense after best practices #4929

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

Merged
merged 1 commit into from
Feb 1, 2015
Merged

Remove block which doesn't make sense after best practices #4929

merged 1 commit into from
Feb 1, 2015

Conversation

ifdattic
Copy link
Contributor
Q A
Doc fix? yes
New docs? no
Applies to 2.3
Fixed tickets

| Q             | A
| ------------- | ---
| Doc fix?      | yes
| New docs?     | no
| Applies to    | 2.3
| Fixed tickets |
@wouterj
8000 Copy link
Member
wouterj commented Jan 27, 2015

Why doesn't it make sense? It still makes very much sense, as it's showing you how to pass parameters as arguments.

@ifdattic
Copy link
Contributor Author

OK haven't thought about that, it's a valid use case. But I still think the description for example should be reworded as right now after reading it the first thing that comes to mind is it showing how to set a class for service using a parameter (which is discontinued as the best practice is just to enter the class).

@wouterj
Copy link
Member
wouterj commented Jan 27, 2015

Hmm, indeed. The example was updated, but the description isn't.

@ifdattic
Copy link
Contributor Author

This was exactly my thought that the example was updated to follow best practices, but the description was missed. Also why I think it's not needed is because just a few paragraphs above this example there is the same code example making this a duplicate.

@xabbuh
Copy link
Member
xabbuh commented Jan 28, 2015

I think you are right. It doesn't make much sense to show the example twice.

@wouterj
Copy link
Member
wouterj commented Jan 31, 2015

Hmm, I indeed think we should remove it. We'll miss information about using parameters in service definitions, rather than just in arguments. But now class parameters are deprecated, does it make sense to tell people about it?

@weaverryan
Copy link
Member

Great detective work guys - I fully agree. Thanks!

@weaverryan weaverryan merged commit 26415e2 into symfony:2.3 Feb 1, 2015
weaverryan added a commit that referenced this pull request Feb 1, 2015
…s (ifdattic)

This PR was merged into the 2.3 branch.

Discussion
----------

Remove block which doesn't 
6F1C
make sense after best practices

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

Commits
-------

26415e2 Remove block which doesn't make sense after best practices
@ifdattic ifdattic deleted the patch-7 branch February 2, 2015 08:45
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
0