some jsdoc for #70231

src/vs/vscode.proposed.d.ts

@@ -36,12 +36,26 @@ declare module 'vscode' {
 
 	export interface CallHierarchyItemProvider {
 
+		/**
+		 * Given a document and position compute a call hierarchy item. This is justed as
+		 * anchor for call hierarchy and then `resolveCallHierarchyItem` is being called.
+		 */
 		provideCallHierarchyItem(
 			document: TextDocument,
 			postion: Position,
 			token: CancellationToken
 		): ProviderResult<CallHierarchyItem>;
 
+		/**
+		 * Resolve a call hierarchy item, e.g. compute all calls from or to a function.
+		 * The result is an array of item/location-tuples. The location in the returned tuples
+		 * is always relative to the "caller" with the caller either being the provided item or
+		 * the returned item.
+		 *
+		 * @param item A call hierarchy item previously returned from `provideCallHierarchyItem` or `resolveCallHierarchyItem`
+		 * @param direction Resolve calls from a function or calls to a function
+		 * @param token A cancellation token
+		 */
 		resolveCallHierarchyItem(
 			item: CallHierarchyItem,
 			direction: CallHierarchyDirection,