diff --git a/logstash/logstash.yml b/logstash/logstash.yml
index e2f3471..ffc23a1 100644
--- a/logstash/logstash.yml
+++ b/logstash/logstash.yml
@@ -25,7 +25,9 @@
 # Which directory should be used by logstash and its plugins
 # for any persistent needs. Defaults to LOGSTASH_HOME/data
 #
-path.data: /var/lib/logstash
+# Note: This will be overridden by --path.data flag if provided
+# Linux: /var/lib/logstash, macOS: /usr/local/var/lib/logstash
+# path.data: /var/lib/logstash
 #
 # ------------ Pipeline Settings --------------
 #
@@ -83,8 +85,9 @@ path.data: /var/lib/logstash
 # ------------ Pipeline Configuration Settings --------------
 #
 # Where to fetch the pipeline configuration for the main pipeline
-#
-# path.config:
+# Note: This will be overridden by --path.config flag if provided
+# Linux: /etc/logstash/conf.d/*.conf, macOS: /usr/local/etc/logstash/conf.d/*.conf
+# path.config: /etc/logstash/conf.d/*.conf
 #
 # Pipeline configuration string for the main pipeline
 #
@@ -316,7 +319,9 @@ path.data: /var/lib/logstash
 # log.format: plain
 # log.format.json.fix_duplicate_message_fields: false
 #
-path.logs: /var/log/logstash
+# Note: This will be overridden by --path.logs flag if provided
+# Linux: /var/log/logstash, macOS: /usr/local/var/log/logstash
+# path.logs: /var/log/logstash
 #
 # ------------ Other Settings --------------
 #