dcos: clarification about YAML validation error

added a clarification about PR comment on PipelineRun
validation errors.

Signed-off-by: Zaki Shaikh <[email protected]>

Author: zakisk

docs/content/docs/guide/running.md

@@ -125,11 +125,11 @@ click on it and follow the pipeline execution directly there.
 ## Errors When Parsing PipelineRun YAML
 
 When Pipelines-As-Code encounters an issue with the YAML formatting in the
-repository, it will log the error in the user namespace events log and
+repository, it will create comment on pull request describing the error and will log the error in the user namespace events log and
 the Pipelines-as-Code controller log.
 
-Despite the error, Pipelines-As-Code will continue to run other correctly parsed
-and matched PipelineRuns.
+Despite validation errors, Pipelines-as-Code continues to run other correctly parsed and matched PipelineRuns.
+However, if a PipelineRun has YAML syntax error, it halts the execution of all PipelineRuns, even those that are syntactically correct.
 
 {{< support_matrix github_app="true" github_webhook="true" gitea="true" gitlab="true" bitbucket_cloud="false" bitbucket_server="false" >}}