diff --git a/config/sample-development.engine-core.ini b/config/sample-development.engine-core.ini
index 6fa74c633ff022f5dda66787319fd4b6946f58f9..75e68eb7b28461e59a1a4afb5fae4829cf55f671 100644
--- a/config/sample-development.engine-core.ini
+++ b/config/sample-development.engine-core.ini
@@ -56,21 +56,19 @@ output_device_2=""
 output_device_3=""
 output_device_4=""
 
-# If you are using Alsa, you most probably have to tweak these values
-# out of the box you will hear alot of cracklings and artifacts
+# If you are using ALSA, you might need to tweak these values if you're hearing jitter, cracklings or other artifacts
 
-
-# alsa_buffer => int
-alsa_buffer="8192"
-#alsa_buffer="16384"
-# alsa_buffer_length => int
-alsa_buffer_length="25"
-# alsa_periods => int
+# Set to 0 to use the ALSA default.
+alsa_buffer="0"
+# Only used for buffered ALSA I/O, and affects latency. Probably not wanted for live audio. Defaults to "1"
+alsa_buffer_length="0"
+# # Set to 0 to use the ALSA default. Defaults to "0"
 alsa_periods="0"
-# frame_duration => double
-frame_duration=""
-# frame_size => int
+# Frame Size ("frame.audio.size"); Unclear if that's still required as it's not documented in Liquidsoap anymore.
 frame_size=""
+# Tentative frame duration in seconds, defaults to "0.04" (Float). This setting is used as a hint for the duration, 
+# when ‘frame_size’ is not provided. It's required for getting things in sync, but it's actually tricky to set correctly.
+frame_duration=""
 
 [stream]
 # defines enabled or not
diff --git a/config/sample-docker.engine-core.ini b/config/sample-docker.engine-core.ini
index 0667c5ba3b2a15de61cf24b7c868b8f9b5ed400c..ebba40cf86e22565262a6e7faa3f4ad501600d89 100644
--- a/config/sample-docker.engine-core.ini
+++ b/config/sample-docker.engine-core.ini
@@ -56,21 +56,19 @@ output_device_2=""
 output_device_3=""
 output_device_4=""
 
-# If you are using Alsa, you most probably have to tweak these values
-# out of the box you will hear alot of cracklings and artifacts
+# If you are using ALSA, you might need to tweak these values if you're hearing jitter, cracklings or other artifacts
 
-
-# alsa_buffer => int
-#alsa_buffer="8192"
-alsa_buffer="16384"
-# alsa_buffer_length => int
-alsa_buffer_length="25"
-# alsa_periods => int
+# Set to 0 to use the ALSA default.
+alsa_buffer="0"
+# Only used for buffered ALSA I/O, and affects latency. Probably not wanted for live audio. Defaults to "1"
+alsa_buffer_length="0"
+# # Set to 0 to use the ALSA default. Defaults to "0"
 alsa_periods="0"
-# frame_duration => double
-frame_duration=""
-# frame_size => int
+# Frame Size ("frame.audio.size"); Unclear if that's still required as it's not documented in Liquidsoap anymore.
 frame_size=""
+# Tentative frame duration in seconds, defaults to "0.04" (Float). This setting is used as a hint for the duration, 
+# when ‘frame_size’ is not provided. It's required for getting things in sync, but it's actually tricky to set correctly.
+frame_duration=""
 
 [stream]
 # defines enabled or not
diff --git a/config/sample-production.engine-core.ini b/config/sample-production.engine-core.ini
index dc168f0c15a44be325ad1f6797ce9f66030a2124..75e68eb7b28461e59a1a4afb5fae4829cf55f671 100644
--- a/config/sample-production.engine-core.ini
+++ b/config/sample-production.engine-core.ini
@@ -56,21 +56,19 @@ output_device_2=""
 output_device_3=""
 output_device_4=""
 
-# If you are using Alsa, you most probably have to tweak these values
-# out of the box you will hear alot of cracklings and artifacts
+# If you are using ALSA, you might need to tweak these values if you're hearing jitter, cracklings or other artifacts
 
-
-# alsa_buffer => int
-#alsa_buffer="8192"
-alsa_buffer="16384"
-# alsa_buffer_length => int
-alsa_buffer_length="25"
-# alsa_periods => int
+# Set to 0 to use the ALSA default.
+alsa_buffer="0"
+# Only used for buffered ALSA I/O, and affects latency. Probably not wanted for live audio. Defaults to "1"
+alsa_buffer_length="0"
+# # Set to 0 to use the ALSA default. Defaults to "0"
 alsa_periods="0"
-# frame_duration => double
-frame_duration=""
-# frame_size => int
+# Frame Size ("frame.audio.size"); Unclear if that's still required as it's not documented in Liquidsoap anymore.
 frame_size=""
+# Tentative frame duration in seconds, defaults to "0.04" (Float). This setting is used as a hint for the duration, 
+# when ‘frame_size’ is not provided. It's required for getting things in sync, but it's actually tricky to set correctly.
+frame_duration=""
 
 [stream]
 # defines enabled or not