Fixed after Fabien's review

symfony · weaverryan · Nov 12, 2017 · Nov 7, 2017 · Nov 8, 2017 · Nov 8, 2017
commit 335e461fe8800bb6a2c0ae99a8e49ee6e756b11d
diff --git a/best_practices/business-logic.rst b/best_practices/business-logic.rst
@@ -35,10 +35,11 @@ Services: Naming and Configuration
    Use autowiring to automate the configuration of application services.

 :doc:`Service autowiring </service_container/autowiring>` is a feature provided
-by Symfony's Service Container to manage services with minimal configuration.
-It reads the type-hints on your constructor (or other methods) and automatically
-passes you the correct services. It can also add :doc:`service tags </service_container/tags>`
-to the services needed them, such as Twig extensions, event subscribers, etc.
+by Symfony's Service Container to manage services with minimal configuration. It
+reads the type-hints on your constructor (or other methods) and automatically
+passes the correct services to each method. It can also add
+:doc:`service tags </service_container/tags>` to the services needed them, such
+as Twig extensions, event subscribers, etc.

 The blog application needs a utility that can transform a post title (e.g.
 "Hello World") into a slug (e.g. "hello-world") to include it as part of the
@@ -61,10 +62,6 @@ If you're using the :ref:`default services.yaml configuration <service-container
 this class is auto-registered as a service whose ID is ``App\Utils\Slugger`` (or
 simply ``Slugger::class`` if the class is already imported in your code).

-Traditionally, the naming convention for a service was a short, but unique
-snake case key - e.g. ``app.utils.slugger``. But for most services, you should now
-use the class name.
-
 .. best-practice::

    The id of your application's services should be equal to their class name,

diff --git a/best_practices/creating-the-project.rst b/best_practices/creating-the-project.rst
@@ -8,10 +8,10 @@ Installing Symfony

    Use Composer and Symfony Flex to create and manage Symfony applications.

-`Composer`_ is the package manager used by modern PHP application to manage their
-dependencies. `Symfony Flex`_ is a Composer plugin designed to automatize some
-of the most common tasks performed in Symfony applications. Using Flex is optional
-but recommended because it improves your productivity significantly.
+`Composer`_ is the package manager used by modern PHP application to manage
+their dependencies. `Symfony Flex`_ is a Composer plugin designed to automate
+some of the most common tasks performed in Symfony applications. Using Flex is
+optional but recommended because it improves your productivity significantly.

 .. best-practice::