Refresh documentation

docs/behat/index.rst

@@ -1,6 +1,10 @@
 The BDD Guide
 =============
 
+.. note::
+
+    This section is based on the great `Sylius documentation <http://docs.sylius.com>`_.
+
 Behaviour driven development is an approach to software development process that provides software development and management teams
 with shared tools and a shared process to collaborate on software development. The awesome part of BDD is its ubiquitous language,
 which is used to describe the software in English-like sentences of domain specific language.

docs/book/architecture/index.rst

@@ -1,6 +1,10 @@
 Architecture
 ============
 
+.. note::
+
+    This section is based on the great `Sylius documentation <http://docs.sylius.com>`_.
+
 Before we dive separately into every Monofony concept, you need to have an overview of how our main application is structured.
 In this chapter we will sketch this architecture and our basic, cornerstone concepts, but also some supportive approaches,
 that you need to notice.

docs/cookbook/deployment/capistrano.rst

@@ -0,0 +1,81 @@
+How to deploy using Capistrano
+==============================
+
+.. note::
+
+    This page give some hit about Capistrano. To go further check `the official documentation <http://capistranorb.com/>`_
+
+Capistrano is a common tools to deploy a Symfony app. It allows to deploy your app without any interruption.
+Your document root in on a symlink which corresponds to a release directory.
+This symlink is updated when your build finished successfully.
+
+
+Install Dependencies
+--------------------
+
+We are going to use `Bundler`_ to install capistrano
+
+.. code-block:: bash
+
+    $ gem install bundler
+
+Run bundler install command to install gem dependancies in the project Gemfile
+
+
+.. code-block:: bash
+
+    $ bundle install
+
+.. _Bundler: http://bundler.io
+
+Configure your environments
+---------------------------
+
+By defaults, there are two environments pre-configured:
+
+* staging
+* production
+
+These environments are configured in on ``etc/capistrano/deploy/`` directory.
+Replace ``XX.XXX.XX.XXX`` with your server ip addresses
+
+Deploy the staging environment
+------------------------------
+
+.. code-block:: bash
+
+    $ bundle exec "cap staging deploy"
+
+Deploy the production environment
+---------------------------------
+
+.. code-block:: bash
+
+    $ bundle exec "cap production deploy"
+
+Create your own task
+--------------------
+
+Capistrano allow you to build your own to exec during your deployment.
+This exemple create a task that execute a command on deployment target server.
+
+.. code-block:: ruby
+
+    namespace :namespace do
+        desc "task description"
+        task :task_name do
+          on roles(:all) do |host|
+                  execute 'command executed on target server'
+          end
+        end
+    end
+
+Tasks hooks
+-----------
+
+Capistrano provides hooks in order to exec your task before or after a specific task.
+For example if you want to run a task to set a proxy on a remote server before any git check :
+
+.. code-block:: ruby
+
+    before 'git:check', 'deploy:add_proxy'

docs/cookbook/deployment/map.rst.inc

@@ -0,0 +1 @@
+* :doc:`/cookbook/deployment/capistrano`

docs/cookbook/index.rst

@@ -28,12 +28,12 @@ Fixtures
 .. include:: /cookbook/fixtures/map.rst.inc
 
 
-Capistrano
+Deployment
 ----------
 
 .. toctree::
     :hidden:
 
-    capistrano
+    deployment/capistrano
 
-.. include:: /cookbook/map.rst.inc
+.. include:: /cookbook/deployment/map.rst.inc

docs/cookbook/map.rst.inc

@@ -1 +1 @@
-* :doc:`/cookbook/capistrano`
+* :doc:`/cookbook/index`

docs/index.rst

@@ -36,8 +36,6 @@ The Cookbook
 
     cookbook/index
 
-.. include:: /cookbook/map.rst.inc
-
 The Behat Guide
 ---------------