From 577d050f7b3139dfde4ac30a891fa9f00d851a32 Mon Sep 17 00:00:00 2001
From: jurgenhaas <juergen@paragon-es.de>
Date: Fri, 15 Jan 2021 13:10:17 +0100
Subject: [PATCH] Add a small section to describe relationship between L3D and
 Drupal development

---
 docs/docker/l3d/drupal.md | 49 +++++++++++++++++++++++++++++++++++++++
 mkdocs.yml                |  1 +
 2 files changed, 50 insertions(+)
 create mode 100644 docs/docker/l3d/drupal.md

diff --git a/docs/docker/l3d/drupal.md b/docs/docker/l3d/drupal.md
new file mode 100644
index 0000000..b1808cd
--- /dev/null
+++ b/docs/docker/l3d/drupal.md
@@ -0,0 +1,49 @@
+---
+title: Docker L3D and Drupal Projects
+tags:
+- docker
+---
+# L3D and Drupal Projects
+
+We do provide a couple of project templates for Drupal projects out of the box:
+
+- [Drupal 8](/composer/project/d8/)
+- [Drupal 9](/composer/project/d9/)
+
+If you prefer to use your own prroject template, you'll get the most out of
+L3D if you add our ccomposer plugin [drupal-development-environment](/composer/plugin/drupal-dev-environment/)
+to your required dev components:
+
+```bash
+composer require-dev lakedrops/drupal-development-environment
+```
+
+This comes with all the dependencies, that help you in local Drupal development:
+
+- [Ahoy](/composer/plugin/ahoy/)
+- [Behat](/composer/plugin/b4d/)
+- [Docker4Drupal](/composer/plugin/d4d/)
+- [Dorgflow](/composer/plugin/dorgflow/)
+- [Drupal Environment](/composer/plugin/drupal-environment/)
+- [Traefik](/composer/library/traefik/)
+- [Utilities](/composer/library/composer-json-utils/)
+
+You'll find the documentation for each of these tools in their own section.
+
+In the current context, just an extra note on the drupal-environment plugin: this
+has been moved out of drupal-development-environment and contains all the tasks
+and templates to initially build the directory structure and setting files.
+
+It is a great idea to utilize the same structure in your production environment
+too. To get there, you can simply add this plugin to your regular requirements:
+
+```bash
+composer require lakedrops/drupal-environment
+```
+
+In both cases, development and production, your project settings for this
+toolset goes into the file `.lakedrops.yml` in your project root and each
+project describes in its own documentation, what values go into this file so
+that you get similar (but not identical) setup on all stages. It should not
+be identical, because you don't want all the development tools on your 
+production site.
diff --git a/mkdocs.yml b/mkdocs.yml
index f5b76f2..9fec608 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -36,6 +36,7 @@ nav:
       - Changelog: docker/gitlab-drupal-ci/changelog.md
     - L3D:
       - Home: docker/l3d/index.md
+      - Drupal: docker/l3d/drupal.md
       - Changelog: docker/l3d/changelog.md
     - Maven: docker/maven-build/index.md
     - Node: docker/node/index.md
-- 
GitLab