From 30e2b08c725703ab314416a3cd4d9ba2c9a184ce Mon Sep 17 00:00:00 2001
From: cytopia <cytopia@everythingcli.org>
Date: Sat, 14 Nov 2020 11:59:32 +0100
Subject: [PATCH] Fixes #547 Added link to official Contao Devilbox docs

---
 CHANGELOG.md                      |  2 ++
 docs/_includes/links/examples.rst | 10 ++++++++--
 docs/examples/setup-contao.rst    |  8 +++++++-
 3 files changed, 17 insertions(+), 3 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 2d848aa8..a0948112 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -18,6 +18,8 @@ major versions.
 #### Added
 - [#707](https://github.com/cytopia/devilbox/issues/707) New `.env` variable: `HOST_PATH_BACKUPDIR`
 
+#### Changed
+- [#547](https://github.com/cytopia/devilbox/issues/547) Added link to official Contao Devilbox Documentation
 
 
 ## Release v1.8.1 (2020-11-12)
diff --git a/docs/_includes/links/examples.rst b/docs/_includes/links/examples.rst
index 5f76f6f1..7aa30edd 100644
--- a/docs/_includes/links/examples.rst
+++ b/docs/_includes/links/examples.rst
@@ -16,6 +16,12 @@
      Official Contao Documentation <img src="https://raw.githubusercontent.com/cytopia/icons/master/11x11/ext-link.png" />
    </a>
 
+.. |ext_lnk_example_contao_devilbox_documentation| raw:: html
+
+   <a target="_blank" href="https://docs.contao.org/manual/en/guides/local-installation/devilbox/">
+     Official Contao Devilbox Documentation <img src="https://raw.githubusercontent.com/cytopia/icons/master/11x11/ext-link.png" />
+   </a>
+
 .. |ext_lnk_example_craftcms_documentation| raw:: html
 
    <a target="_blank" href="https://docs.craftcms.com/v3/installation.html#step-1-download-craft">
@@ -28,13 +34,13 @@
      Official Drupal Documentation <img src="https://raw.githubusercontent.com/cytopia/icons/master/11x11/ext-link.png" />
    </a>
 
-.. |ext_lnk_example_expressionengine_documentation| raw:: html  
+.. |ext_lnk_example_expressionengine_documentation| raw:: html
 
    <a target="_blank" href="https://docs.expressionengine.com/latest/index.html">
      Official ExpressionEngine Documentation <img src="https://raw.githubusercontent.com/cytopia/icons/master/11x11/ext-link.png" />
    </a>
 
-.. |ext_lnk_example_expressionengine_primer| raw:: html  
+.. |ext_lnk_example_expressionengine_primer| raw:: html
 
    <a target="_blank" href="https://docs.expressionengine.com/latest/getting-started/ten-minute-primer.html">
      10 Minute Primer <img src="https://raw.githubusercontent.com/cytopia/icons/master/11x11/ext-link.png" />
diff --git a/docs/examples/setup-contao.rst b/docs/examples/setup-contao.rst
index b57184df..f543115e 100644
--- a/docs/examples/setup-contao.rst
+++ b/docs/examples/setup-contao.rst
@@ -7,6 +7,10 @@
 Setup Contao
 ************
 
+.. important::
+   **You can find a more up-to-date version in the official Contao Documentation:**
+   |ext_lnk_example_contao_devilbox_documentation|
+
 This example will use ``composer`` to install Contao CMS from within the Devilbox PHP container.
 
 .. important::
@@ -19,7 +23,9 @@ This example will use ``composer`` to install Contao CMS from within the Devilbo
 After completing the below listed steps, you will have a working Contao CMS setup ready to be
 served via http and https.
 
-.. seealso:: |ext_lnk_example_contao_documentation|
+.. seealso::
+   * |ext_lnk_example_contao_documentation|
+   * |ext_lnk_example_contao_devilbox_documentation|
 
 
 **Table of Contents**