Fixing doc comment for new api

src/vs/vscode.proposed.d.ts

@@ -1629,7 +1629,13 @@ declare module 'vscode' {
 		/**
 		 * Static documentation for a class of code actions.
 		 *
-		 * The documentation is shown at the
+		 * The documentation is shown in the code actions menu if either:
+		 *
+		 * - Code actions of `kind` are requested by VS Code. Note that in this case, we always pick the most specific
+		 *  documentation. For example, if documentation for both `Refactor` and `RefactorExtract` is provided, and we
+		 *  request code actions for `RefactorExtract`, we prefer the more specific documentation for `RefactorExtract`.
+		 *
+		 * - Any code actions of `kind` are returned by the provider.
 		 */
 		readonly documentation?: ReadonlyArray<{ readonly kind: CodeActionKind, readonly command: Command }>;
 	}