Documentation: Add IMPORTANT section

docs/getting-started/important.rst

@@ -0,0 +1,59 @@
+*********
+IMPORTANT
+*********
+
+The following is a collection of important **do's and don'ts** you should be aware of when starting
+to use the Devilbox and Docker in general.
+
+**Table of Contents**
+
+.. contents:: :local:
+
+
+Starting
+========
+
+Do not run via ``sudo`` or ``root``
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Do not start the Devilbox with ``sudo`` or as ``root`` user. If it complains about permissions when
+starting it with your normal system user, it is probably due to the fact, that your user is not in
+the ``docker`` group.
+
+.. seealso:: **Ensure you have read and done the following:**
+
+   * Add user to ``docker`` group: :ref:`prerequisites_docker_installation`
+   * Synronize file permissions: :ref:`install_the_devilbox_set_uid_and_gid`
+
+.. warning:: If you start the Devilbox with ``sudo`` or as ``root`` user, it will most likely mess with your file permissions.
+
+
+Starting, Stopping and Restarting
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Whenever you want to stop the Devilbox, change configuration and start up again, do not forget to
+remove stopped container.
+
+.. code-block:: bash
+
+   # Stop the Devilbox
+   host> docker-compose stop
+
+   # Remove stopped container
+   host> docker-compose rm
+
+   # Start the Devilbox
+   host> docker-compose up
+
+.. seealso:: :ref:`start_the_devilbox_stop_and_restart` (why do ``docker-compose rm``?)
+
+
+Backups
+=======
+
+Ensure to do regular database backups! Better safe then sorry!
+
+.. seealso::
+   * :ref:`backup_and_restore_mysql`
+   * :ref:`backup_and_restore_pgsql`
+   * :ref:`backup_and_restore_mongo`

docs/getting-started/install-the-devilbox.rst

@@ -52,6 +52,8 @@ of settings (such as which version to start up).
    * :ref:`env_file`
 
 
+.. _install_the_devilbox_set_uid_and_gid:
+
 Set uid and gid
 ===============
 

docs/getting-started/prerequisites.rst

@@ -66,6 +66,8 @@ Additionally you will require ``git`` in order to clone the devilbox project.
    * :ref:`howto_find_docker_and_docker_compose_version`
 
 
+.. _prerequisites_docker_installation:
+
 Docker installation
 ===================
 

docs/index.rst

@@ -50,6 +50,7 @@ host is ready to be served with your custom domain.
    getting-started/create-your-first-project
    getting-started/enter-the-php-container
    getting-started/change-container-versions
+   getting-started/important
 
 
 .. toctree::