-
-
Notifications
You must be signed in to change notification settings - Fork 5.2k
Documentation: add missing php tags / "use" statements #8324
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
Conversation
not sure if these were needed <br>However, this was the only way I was able to get the page creation working on my macintosh computer. Cheers, Michael Dimmitt Happy to have a discussion about this PR.
|
||
// ... |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
We use this placeholder comment in many places to indicate that the code example is not complete. This is usually done when the code evolves during the reader following an article down from the top. We then just try to add what is new for this specific example.
In this file, the LuckyController
class was already introduced before (in the other code example that you changed) including the needed namespace and use
statements.
Furthermore, we omit the opening <?php
tags everywhere for brevity to keep all code examples as small as possible.
Thus, for me there is nothing to change here. Anyway, thank you very much for opening this PR. We really appreciate people coming with feedback and trying to improve the docs.
@MichaelDimmitt your proposal is 100% correct ... but as @xabbuh said, we made some decisions to make docs easier to read and maintain. So, we don't need to add It's sad because this was going to be your first contribution to Symfony Docs ... but I'm sure there will be more opportunities to contribute. Thanks! |
@javiereguiluz @xabbuh, here is an idea for another pull request. ideas/options:
Possibly your target is veteran php programmers. I was not sure if magic could happen in a framework that allowed a php file to run without a beginning Any of these changes I would be happy to mock up in a new pull request. Positive experience with symfony so far, good work to you both and your team. :) |
Not sure if these were needed
However, this was the only way I was able to get the page creation working on my:
macintosh computer (mac)
Left the ending php tag out which seemed the convention after looking at the default_controller.
Cheers, Michael Dimmitt 🙂
Happy to have a discussion about this PR.
And add any additional details.
elsewise this would be the error,