From 91acc9d3b4bea697600c70c6f1d105e1b16de3e4 Mon Sep 17 00:00:00 2001
From: Walter Lozano <walter.lozano@collabora.com>
Date: Fri, 29 Jan 2021 10:22:22 -0300
Subject: [PATCH] Improve the description of image creation

Add to the platform document and introduction to the image generation about
debos and the versatility it provides to build customized images.

Signed-off-by: Walter Lozano <walter.lozano@collabora.com>
---
 content/architecture/platform-guide.md | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/content/architecture/platform-guide.md b/content/architecture/platform-guide.md
index ba4666e3b..7ee68f8e1 100644
--- a/content/architecture/platform-guide.md
+++ b/content/architecture/platform-guide.md
@@ -317,6 +317,18 @@ by the [Apertis GitLab instance](https://gitlab.apertis.org/):
 
 ## Image creation
 
+Image creation is the point where a set of standard packages are combined to
+build a solution for a specific use case. This goal is accomplish thanks to
+[Debos](https://github.com/go-debos/debos), a flexible tool to configure the
+build of Debian-based operating systems. Debos uses tools like `debootstrap`
+already present in the environment and relies on virtualisation to securely do
+privileged operations without requiring root access.
+
+Additionally at this stage customizations can be applied by using overlays.
+This process allows the default content of the packages to be combined with
+custom modifications to provide the desired solution. A common case is to apply overlays to
+change some default system settings found in `/etc` such as default hostname.
+
 Ospacks and how they should be processed to generate images are defined through
 YAML files.
 
-- 
GitLab