Clarify API

src/vs/editor/common/modes.ts

@@ -371,22 +371,22 @@ export let completionKindFromString: {
 
 export interface CompletionItemLabel {
 	/**
-	 * The function or variable
+	 * The function or variable. Rendered leftmost.
 	 */
 	name: string;
 
 	/**
-	 * The signature, without the return type. is render directly after `name`
+	 * The signature without the return type. Render after `name`.
 	 */
 	signature?: string;
 
 	/**
-	 * The fully qualified name, like package name, file path etc
+	 * The fully qualified name, like package name or file path. Rendered after `signature`.
 	 */
 	qualifier?: string;
 
 	/**
-	 * The return-type of a function or type of a property, variable etc
+	 * The return-type of a function or type of a property/variable. Rendered rightmost.
 	 */
 	type?: string;
 }

src/vs/monaco.d.ts

@@ -5199,19 +5199,19 @@ declare namespace monaco.languages {
 
 	export interface CompletionItemLabel {
 		/**
-		 * The function or variable
+		 * The function or variable. Rendered leftmost.
 		 */
 		name: string;
 		/**
-		 * The signature, without the return type. is render directly after `name`
+		 * The signature without the return type. Render after `name`.
 		 */
 		signature?: string;
 		/**
-		 * The fully qualified name, like package name, file path etc
+		 * The fully qualified name, like package name or file path. Rendered after `signature`.
 		 */
 		qualifier?: string;
 		/**
-		 * The return-type of a function or type of a property, variable etc
+		 * The return-type of a function or type of a property/variable. Rendered rightmost.
 		 */
 		type?: string;
 	}

src/vs/vscode.proposed.d.ts

@@ -1387,22 +1387,22 @@ declare module 'vscode' {
 
 	export interface CompletionItemLabel {
 		/**
-		 * The function or variable
+		 * The function or variable. Rendered leftmost.
 		 */
 		name: string;
 
 		/**
-		 * The signature, without the return type. is render directly after `name`
+		 * The signature without the return type. Render after `name`.
 		 */
 		signature?: string;
 
 		/**
-		 * The fully qualified name, like package name, file path etc
+		 * The fully qualified name, like package name or file path. Rendered after `signature`.
 		 */
 		qualifier?: string;
 
 		/**
-		 * The return-type of a function or type of a property, variable etc
+		 * The return-type of a function or type of a property/variable. Rendered rightmost.
 		 */
 		type?: string;
 	}