Fixes #1674: Clarify the query format/syntax for WorkspaceSymbolParams (#1977)

Author: dbaeumer

_specifications/lsp/3.18/workspace/symbol.md

@@ -104,6 +104,12 @@ interface WorkspaceSymbolParams extends WorkDoneProgressParams,
 	/**
 	 * A query string to filter symbols by. Clients may send an empty
 	 * string here to request all symbols.
+	 *
+	 * The `query`-parameter should be interpreted in a *relaxed way* as editors
+	 * will apply their own highlighting and scoring on the results. A good rule
+	 * of thumb is to match case-insensitive and to simply check that the
+	 * characters of *query* appear in their order in a candidate symbol.
+	 * Servers shouldn't use prefix, substring, or similar strict matching.
 	 */
 	query: string;
 }

_specifications/specification-3-16.md

@@ -3272,6 +3272,12 @@ interface WorkspaceSymbolParams extends WorkDoneProgressParams,
 	/**
 	 * A query string to filter symbols by. Clients may send an empty
 	 * string here to request all symbols.
+	 *
+	 * The `query`-parameter should be interpreted in a *relaxed way* as editors
+	 * will apply their own highlighting and scoring on the results. A good rule
+	 * of thumb is to match case-insensitive and to simply check that the
+	 * characters of *query* appear in their order in a candidate symbol.
+	 * Servers shouldn't use prefix, substring, or similar strict matching.
 	 */
 	query: string;
 }