add longMessage field to Diagnostic

_specifications/lsp/3.18/types/diagnostic.md

@@ -34,10 +34,22 @@ export interface Diagnostic {
 	source?: string;
 
 	/**
-	 * The diagnostic's message.
+	 * The diagnostic's message, e.g. 'Unknown type name "int_8_t"'.
 	 */
 	message: string;
 
+	/**
+	 * An optional property to describe this diagnostic's message with more
+	 * details. For example:
+	 * The type name "int_8_t" is unknown. Did you mean any of these types?
+	 * - int
+	 * - int8_t
+	 * Read more about the built-in types [here](file:///path/to/docs.md).
+	 *
+	 * @since 3.18.0
+	 */
+	longMessage?: string | MarkupContent;
+
 	/**
 	 * Additional metadata about the diagnostic.
 	 *
@@ -155,4 +167,4 @@ export interface CodeDescription {
 	 */
 	href: URI;
 }
-```
+```