diff --git a/LSP.sublime-settings b/LSP.sublime-settings
index 79eb1f2d4..a53fd2e0e 100644
--- a/LSP.sublime-settings
+++ b/LSP.sublime-settings
@@ -295,12 +295,14 @@
   //     "env": { },
   //
   //     // Sets the diagnostics mode:
-  //     // "open_files" - if the server supports `diagnosticProvider`, diagnostics
-  //     //     are requested only for files which are opened in the editor and they
+  //     // "open_files" - All diagnostics reported from the server are shown.
+  //     //     If the server supports `diagnosticProvider`, diagnostics are
+  //     //     requested only for files which are opened in the editor and they
   //     //     are cleared when the file gets closed.
-  //     // "workspace" - if the server supports `diagnosticProvider.workspaceDiagnostics`,
-  //     //     diagnostics are requested for all files in the project folders. Diagnostics
-  //     //     reported for files not within the project folders are ignored.
+  //     // "workspace" - Diagnostics reported for files not within the project
+  //     //     folders are ignored. If the server supports
+  //     //     `diagnosticProvider.workspaceDiagnostics`, diagnostics are
+  //     //     requested for all files in the project folders.
   //     "diagnostics_mode": "open_files",
   //   }
   // }