diff --git a/src/vs/workbench/services/hover/browser/hover.ts b/src/vs/workbench/services/hover/browser/hover.ts
index 1602396e2dd..a504b379d65 100644
--- a/src/vs/workbench/services/hover/browser/hover.ts
+++ b/src/vs/workbench/services/hover/browser/hover.ts
@@ -16,7 +16,7 @@ export interface IHoverService {
 	readonly _serviceBrand: undefined;
 
 	/**
-	 * Shows a hover.
+	 * Shows a hover, provided a hover with the same options object is not already visible.
 	 * @param options A set of options defining the characteristics of the hover.
 	 * @param focus Whether to focus the hover (useful for keyboard accessibility).
 	 *