Update documentation

Refactored documentation and add customization section

Author: mblaschke

documentation/docs/content/DockerfilesBuildingProcess/building.rst renamed to documentation/docs/content/BuildingProcess/building.rst

@@ -0,0 +1,12 @@
+=============
+Customization
+=============
+
+This section is not done yet!
+
+
+.. toctree::
+   :maxdepth: 1
+
+   provisioning
+   supervisord

documentation/docs/content/DockerfilesBuildingProcess/customizing.rst renamed to documentation/docs/content/BuildingProcess/customizing.rst

@@ -0,0 +1,36 @@
+============
+Provisioning
+============
+
+.. important:: Provision system is only available in Docker images which are based on ``webdevops/base``!
+
+Provision Events
+----------------
+
+====================================================  ==================================================================
+Provision event/tag                                   Description
+----------------------------------------------------  ------------------------------------------------------------------
+``bootstrap``                                         Run on Docker image creation (only run once)
+``build``                                             Run on Docker image build
+``onbuild``                                           Run on Docker image ONBUILD
+``entrypoint``                                        Run on Docker image entrypoint execution
+                                                      (only here Environment variables are available)
+====================================================  ==================================================================
+
+.. attention:: Try to avoid entrypoint provision tasks because it delays startup time.
+
+Shell script provision
+----------------------
+
+For each provision event there is a directory for shell scripts:
+
+- ``/opt/docker/provision/bootstrap.d/``
+- ``/opt/docker/provision/build.d/``
+- ``/opt/docker/provision/onbuild.d/``
+- ``/opt/docker/provision/entrypoint.d/``
+
+For customization just add your shell scripts into these directories for the simple shell script provision system.
+
+
+Ansible provision
+-----------------

documentation/docs/content/DockerfilesBuildingProcess/index.rst renamed to documentation/docs/content/BuildingProcess/index.rst

@@ -0,0 +1,48 @@
+=================
+Supervisor Daemon
+=================
+
+.. important:: Supervisor is only available in Docker images which are based on ``webdevops/base``!
+
+Introduction
+------------
+
+Supervisor daemon is used to start and supervise more than one process in Docker containers. More about supervisor can
+be found on supervisor homepage at http://supervisord.org/
+
+Configuration
+-------------
+
+The main supervisor configuration file is located at ``/opt/docker/etc/supervisor.conf`` and only controls the
+supervisor daemon itself. All services are configured inside ``/opt/docker/etc/supervisor.d/`` directory.
+
+Example configuration for hhvm::
+
+    [group:hhvm]
+    programs=hhvmd
+    priority=20
+
+    [program:hhvmd]
+    command = /opt/docker/bin/service.d/hhvm.sh
+    process_name=%(program_name)s
+    directory = /var/run/hhvm/
+    user = application
+    startsecs = 0
+    autostart = true
+    autorestart = true
+    stdout_logfile=/dev/stdout
+    stdout_logfile_maxbytes=0
+    stderr_logfile=/dev/stderr
+    stderr_logfile_maxbytes=0
+
+Service daemon scripts
+----------------------
+
+For every service there is a small bash script inside ``/opt/docker/bin/service.d/`` which takes care how to start the
+service. This script also have a modular task runner which runs files from ``/opt/docker/bin/service.d/SERVICE.d/*.sh``.
+
+Example for HHVM:
+
+    HHVM's service script is located at ``/opt/docker/bin/service.d/hhvm.sh``.
+
+    Before running HHVM all scripts found with ``/opt/docker/bin/service.d/hhvm.d/*.sh`` will be executed.