Add browserkit component documentation

components/browser_kit/index.rst

@@ -0,0 +1,7 @@
+BrowserKit
+==========
+
+.. toctree::
+    :maxdepth: 2
+
+    introduction

components/browser_kit/introduction.rst

@@ -0,0 +1,65 @@
+.. index::
+   single: BrowserKit
+   single: Components; BrowserKit
+
+The BrowserKit Component
+========================
+
+    The BrowserKit component simulates the behavior of a web browser.
+
+The BrowserKit component allows you to make web request, click on links and submit forms. 
+
+Installation
+------------
+
+You can install the component in 2 different ways:
+
+* :doc:`Install it via Composer </components/using_components>` (``symfony/browser-kit`` on `Packagist`_);
+* Use the official Git repository (https://github.com/symfony/BrowserKit).
+
+Usage
+-----
+
+.. note::
+    The component only provides an abstract client and does not provide any "default" backend for the HTTP layer.
+
+Making Request
+~~~~~~~~~~~~~~
+
+To make a request you use the client's request method. 
+The first two arguments are for the HTTP method and the request url.
+The request method will return a crawler object.
+
+.. code-block:: php
+
+    use ACME\Client;
+
+    $client = new Client();
+    $crawler = $client->request('GET', 'http://symfony.com');
+
+Clicking Links
+~~~~~~~~~~~~~~
+
+select a link with the crawler and pass it to the click method to click on the link.
+
+.. code-block:: php
+
+    use ACME\Client;
+
+    $client = new Client();
+    $crawler = $client->request('GET', 'http://symfony.com');
+    $link = $crawler->selectLink('Go elsewhere...')->link();
+    $client->click($link);
+
+Submiting Forms
+~~~~~~~~~~~~~~~~
+
+Creating a Client
+-----------------
+
+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/event-dispatcher
+.. _Goutte: https://github.com/fabpot/Goutte

components/index.rst

@@ -5,6 +5,7 @@ The Components
     :hidden:
 
     using_components
+    browser_kit/index
     class_loader/index
     config/index
     console/index

components/map.rst.inc

@@ -1,5 +1,9 @@
 * :doc:`/components/using_components`
 
+* :doc:`/components/browser_kit/index`
+
+  * :doc:`/components/browser_kit/introduction`
+
 * :doc:`/components/class_loader/index`
 
   * :doc:`/components/class_loader/introduction`