diff --git a/docs/static/troubleshooting.asciidoc b/docs/static/troubleshooting.asciidoc
index 017849f1b..cb48217de 100644
--- a/docs/static/troubleshooting.asciidoc
+++ b/docs/static/troubleshooting.asciidoc
@@ -155,8 +155,8 @@ For basic pipelines, this configuration could be enough to make the problem show
 input {stdin{}} output {stdout{}}
 -----
 
-To better identify the offending pipeline, {ls} could separate its logs by pipeline.
-Switch on the log per pipeline feature by enabling it, put `pipeline.separate_logs: true` in your `logstash.yml`.
+{ls} can separate logs by pipeline. This feature can help you identify the offending pipeline. 
+Set `pipeline.separate_logs: true` in your `logstash.yml` to enable the log per pipeline feature.
 
 For more complex pipelines, the problem could be caused by a series of plugins in
 a specific order. Troubleshooting these pipelines usually requires trial and error.