From 562b6d6bfe135111dbbed222316fbe65cd2c99b8 Mon Sep 17 00:00:00 2001
From: fiftydinar <65243233+fiftydinar@users.noreply.github.com>
Date: Wed, 2 Oct 2024 10:14:33 +0200
Subject: [PATCH] docs(bling): Update documentation about
 `dconf-update-service`

---
 modules/bling/README.md | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/modules/bling/README.md b/modules/bling/README.md
index 2dbaacf9..c4df71e0 100644
--- a/modules/bling/README.md
+++ b/modules/bling/README.md
@@ -8,6 +8,11 @@ The bling to pull in is declared under `install:`, and the code for installing t
 
 ### `dconf-update-service`
 
-The `dconf-update-service` submodule creates a systemd unit to automatically update changes you make to [dconf](https://wiki.gnome.org/Projects/dconf) in your custom image. For an example of a dconf keyfile, see the [dconf custom defaults documentation](https://help.gnome.org/admin/system-admin-guide/stable/dconf-custom-defaults.html.en).
+The `dconf-update-service` submodule creates a systemd unit to automatically update changes you make to [dconf](https://wiki.gnome.org/Projects/dconf) in your custom image.
 
-**Unlike the `gschema-overrides` module, dconf keyfiles are not checked at compile time**
+For an example of a dconf keyfile, see the [dconf custom defaults documentation](https://help.gnome.org/admin/system-admin-guide/stable/dconf-custom-defaults.html.en).
+
+Take a note that this documentation is for local-users, not for custom image maintainers. But it serves as a good example of what dconf file looks like.  
+Ignore the advice about creating the `user` profile, as it's already present & just place dconfs in `/etc/dconf/db/distro.d/`, not in `local.d` folder ([Thinking like a distribution](https://blue-build.org/learn/mindset/) mindset).
+
+**Unlike the `gschema-overrides` module, dconf keyfiles are not checked at compile time for errors.**