adding doc about resolve and not waiting when accepting, microsoft#73311

jrieken · jrieken · commit f654e187ce00 · 2019-06-03T16:47:24.000+02:00
diff --git a/src/vs/vscode.d.ts b/src/vs/vscode.d.ts
@@ -3515,6 +3515,10 @@ declare module 'vscode' {
 		 *
 		 * The editor will only resolve a completion item once.
 		 *
+		 * *Note* that accepting a completion item will not wait for it to be resolved. Because of that [`insertText`](#CompletionItem.insertText),
+		 * [`additionalTextEdits`](#CompletionItem.additionalTextEdits), and [`command`](#CompletionItem.command) should not
+		 * be changed when resolving an item.
+		 *
 		 * @param item A completion item currently active in the UI.
 		 * @param token A cancellation token.
 		 * @return The resolved completion item or a thenable that resolves to of such. It is OK to return the given

Original file line number	Diff line number	Diff line change
`@@ -3515,6 +3515,10 @@ declare module 'vscode' {`
`3515`	`3515`	`*`
`3516`	`3516`	`* The editor will only resolve a completion item once.`
`3517`	`3517`	`*`
	`3518`	+ * Note that accepting a completion item will not wait for it to be resolved. Because of that [`insertText`](#CompletionItem.insertText),
	`3519`	+ * [`additionalTextEdits`](#CompletionItem.additionalTextEdits), and [`command`](#CompletionItem.command) should not
	`3520`	`+ * be changed when resolving an item.`
	`3521`	`+ *`
`3518`	`3522`	`* @param item A completion item currently active in the UI.`
`3519`	`3523`	`* @param token A cancellation token.`
`3520`	`3524`	`* @return The resolved completion item or a thenable that resolves to of such. It is OK to return the given`