8000 Update performance.rst by seferov · Pull Request #8332 · symfony/symfony-docs · GitHub
[go: up one dir, main page]

Skip to content

Update performance.rst #8332

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

Closed
wants to merge 3 commits into from
Closed

Update performance.rst #8332

wants to merge 3 commits into from

Conversation

seferov
Copy link
Contributor
@seferov seferov commented Sep 1, 2017

Remove deprecated suggestion

See: symfony/symfony#20668

Deprecated suggestion
Copy link
Member
@wouterj wouterj left a comment

Choose a reason for hiding this comment

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

Great find! Thanks for adding this little note to the docs.

I've added 2 comments where I think this PR can be a little bit updated. If you agree and have some free time, please update your PR (by pushing to the patch-3 branch on your fork). Otherwise, please comment and we'll take care of them! :)

performance.rst Outdated
@@ -165,8 +165,12 @@ For more details, see :doc:`/components/class_loader/cache_class_loader`.
.. index::
single: Performance; Bootstrap files

Use Bootstrap Files
-------------------
Use Bootstrap Files (For < PHP 7)
Copy link
Member

Choose a reason for hiding this comment

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

I think we can leave the title as it was

performance.rst Outdated

.. note::

For PHP 7 and higher versions it is not necessary. It is deprecated for Symfony 4.0.
Copy link
Member

Choose a reason for hiding this comment

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

I believe we used caution directives for deprecations in the docs. I think we should also provide a little bit of context to this message, like this:

.. caution::

    The performance optimalizations in PHP 7 removed any overhead. As such,
    using the bootstrap file is discouraged when using PHP 7+ and was
    deprecated in Symfony 4.0. 

@javiereguiluz
Copy link
Member

@seferov thanks a lot for this proposal.

A quick message to our doc mergers: this article is going to be revamped soon. See #7960. I'll finish it next week. So, decide if it's worth it to merge this PR too. Thanks!

@seferov
Copy link
Contributor Author
seferov commented Sep 3, 2017

@wouterj updated as you requested.

@javiereguiluz I just saw your proposal 👍

performance.rst Outdated

The performance optimalizations in PHP 7 removed any overhead. As such,
using the bootstrap file is discouraged when using PHP 7+ and was
deprecated in Symfony 4.0.
Copy link
Member

Choose a reason for hiding this comment

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

This was deprecated in 3.3. 4.0 will no longer support the bootstrap files.

weaverryan added a commit that referenced this pull request Oct 29, 2017
This PR was merged into the 3.3 branch.

Discussion
----------

Remove outdated performance tips

I've just realized there is an ongoing effort to rewrite this in #8410 and #7960.
But if those are not merged soon, I'd suggest to merge this first so that we can at least solve the broken doc and people don't try to repeatedly fix this, like me and #8332

Commits
-------

d21e200 Remove outdated performance tips
@javiereguiluz
Copy link
Member

Closing it in favor of #9161.

javiereguiluz added a commit that referenced this pull request Jan 30, 2018
…onable (javiereguiluz)

This PR was squashed before being merged into the 2.7 branch (closes #9161).

Discussion
----------

Updated the main performance article to make it more actionable

This one finishes and replaces #7960, #8410 and #8332.

Commits
-------

fa393c5 Updated the main performance article to make it more actionable
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.

5 participants
0