[symfony#1899] Proofreading the new document about starting a project with components

weaverryan · weaverryan · commit 37550da48078 · 2012-11-22T17:39:16.000-05:00
diff --git a/cookbook/map.rst.inc b/cookbook/map.rst.inc
@@ -145,5 +145,6 @@
 
   * :doc:`/cookbook/workflow/new_project_git`
   * :doc:`/cookbook/workflow/new_project_svn`
+  * :doc:`/cookbook/workflow/new_project_components`
 
 * :doc:`/cookbook/deployment-tools`
diff --git a/cookbook/workflow/new_project_components.rst b/cookbook/workflow/new_project_components.rst
@@ -1,35 +1,50 @@
 .. index::
    single: Workflow; Components
 
-How to start a new project using Symfony2 Components
-====================================================
+How to start a new project using the Symfony2 Components
+========================================================
+
+If you're starting a new project that uses one or more Symfony2 components
+(or adding the components to an existing project), the easiest way to integrate
+everything is with Composer. Composer is smart enough to download the component(s)
+that you need and take care of autoloading so that you can begin using the
+libraries immediately.
+
+This article will take you through using the :doc:`/components/finder`, though
+this applies to using any component.
 
 Using Finder Component
 ----------------------
 
-1. Create a new empty folder.
+**1.** Create a new empty directory for your project.
 
-2. Create a new file called ``composer.json`` and paste the following into it:
+**2.** Create a new file called ``composer.json`` and paste the following into it:
 
-   .. code-block:: json
+.. code-block:: json
 
-        {
-            "require": {
-                "symfony/finder": "2.1.*"
-            }
+    {
+        "require": {
+            "symfony/finder": "2.1.*"
         }
+    }
 
-3. Download vendor libraries and generate ``vendor/autoload.php`` file:
+If you already have a ``composer.json`` file, just add this line to it. You
+may also need to adjust the version (e.g. ``2.1.1`` or ``2.2.*``).
 
-   .. code-block:: bash
+You can research the component names and versions at _packagist.org.
 
-        $ php composer.phar install
+**3.** Download the vendor libraries and generate the ``vendor/autoload.php`` file:
 
-4. Write your code:
+.. code-block:: bash
 
-   .. code-block:: php
+    $ php composer.phar install
 
-        <?php
+4. Write your code:
+
+Once Composer has downloaded the component(s), all you need to do is include
+the ``vendor/autoload.php`` file that was generated by Composer. This file
+takes care of autoloading all of the libraries so that you can use them
+immediately::
 
         // File: src/script.php
 
@@ -44,7 +59,8 @@ Using Finder Component
 
 .. tip::
 
-    If you want to use all the Symfony2 Component, then instead of adding them one by one:
+    If you want to use all of the Symfony2 Components, then instead of adding
+    them one by one:
 
         .. code-block:: json
 
@@ -57,7 +73,7 @@ Using Finder Component
                 }
             }
 
-    use:
+    you can use:
 
         .. code-block:: json
 
@@ -66,3 +82,8 @@ Using Finder Component
                     "symfony/symfony": "2.1.*"
                 }
             }
+
+    This will include the Bundle and Bridge libraries, which you may not
+    actually need.
+
+.. _packagist.org: https://packagist.org/
