added form submissions and moved creating a client to top

Author: yamiko-ninja

components/browser_kit/introduction.rst

@@ -23,6 +23,32 @@ Basic Usage
 .. note::
     The component only provides an abstract client and does not provide any "default" backend for the HTTP layer.
 
+Creating a Client
+-----------------
+
+To create your own client you must extend the abstract client class and implement the doRequest method.
+This method accepts a request and should return a response.
+
+.. code-block:: php
+
+    namespace ACME;
+
+    use Symfony\Component\BrowserKit\Client as BaseClient;
+    use Symfony\Component\BrowserKit\Response;
+
+    class Client extends BaseClient {
+        protected function doRequest($request) {
+            // convert request into a response
+            // ...
+            return new Response($content, $status, $headers);
+        }
+    }
+
+For a simple implementation of a browser based on an HTTP layer, have a look at Goutte_.
+
+For an implementation based on HttpKernelInterface, have a look at the Client provided by the :doc:`/components/http_kernel/introduction`.
+
+
 Making Request
 ~~~~~~~~~~~~~~
 
@@ -52,8 +78,23 @@ Select a link with the crawler and pass it to the click method to click on the l
     $client->click($link);
 
 Submiting Forms
-~~~~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~
+
+.. code-block:: php
 
+    use ACME\Client;
+
+    // make a real request to an external site
+    $client = new Client();
+    $crawler = $client->request('GET', 'https://github.com/login');
+
+    // select the form and fill in some values
+    $form = $crawler->selectButton('Log in')->form();
+    $form['login'] = 'symfonyfan';
+    $form['password'] = 'anypass';
+
+    // submit that form
+    $crawler = $client->submit($form);
 
 Cookies
 -------
@@ -64,29 +105,5 @@ History
 Insulated Request
 -----------------
 
-Creating a Client
------------------
-
-To create your own client you must extend the abstract client class and implement the doRequest method.
-This method accepts a request and should return a response.
-
-.. code-block:: php
-    namespace ACME;
-    
-    use Symfony\Component\BrowserKit\Client as BaseClient;
-    use Symfony\Component\BrowserKit\Response;
-
-    class Client extends BaseClient {
-        protected function doRequest($request) {
-            // convert request into a response
-            // ...
-            return new Response($content, $status, $headers);
-        }
-    }
-
-For a simple implementation of a browser based on an HTTP layer, have a look at Goutte_.
-
-For an implementation based on HttpKernelInterface, have a look at the Client provided by the :doc:`/components/http_kernel/introduction`.
-
 .. _Packagist: https://packagist.org/packages/symfony/browser-kit
 .. _Goutte: https://github.com/fabpot/Goutte