diff --git a/conf/client.conf b/conf/client.conf
index 1e11ac898..18db7e304 100644
--- a/conf/client.conf
+++ b/conf/client.conf
@@ -96,3 +96,10 @@ ignore-spm-downgrades|disable
 # Valid parameters: disable, enable, true, false, disabled, enabled
 # Default parameter if unset: disable
 # splitdebug|disable
+# HOW SPLITDEBUG WORKS with Entropy
+# Once you enable the "splitdebug" feature
+# you just need to (re)install packages in order to
+# get /usr/lib/debug metadata files installed. That's it.
+# You can safely remove /usr/lib/debug without affecting
+# Operating System functionality, at any time.
+