diff --git a/src/vs/vscode.proposed.d.ts b/src/vs/vscode.proposed.d.ts
index 94c9f3f88fd6b792a74e4f9e4909ea6638a7d57d..f9ebf92d6a654620556b66655da7547cf76dcdf2 100644
--- a/src/vs/vscode.proposed.d.ts
+++ b/src/vs/vscode.proposed.d.ts
@@ -614,6 +614,13 @@ declare module 'vscode' {
 
 	//#region joh: https://github.com/Microsoft/vscode/issues/10659
 
+	/**
+	 * A workspace edit is a collection of textual and files changes for
+	 * multiple resources and documents. Use the [applyEdit](#workspace.applyEdit)-function
+	 * to apply a workspace edit. Note that all changes are applied in the same order in which
+	 * they have been added and that invalid sequences like 'delete file a' -> 'insert text in
+	 * file a' causes failure of the operation.
+	 */
 	export interface WorkspaceEdit {
 
 		/**