diff --git a/src/vs/vscode.proposed.d.ts b/src/vs/vscode.proposed.d.ts
index 292af786ee1..19e8d8f1032 100644
--- a/src/vs/vscode.proposed.d.ts
+++ b/src/vs/vscode.proposed.d.ts
@@ -2307,12 +2307,12 @@ declare module 'vscode' {
 		/**
 		 * The background color for this entry.
 		 *
-		 * Note: the supported colors for background are currently limited to
-		 * `ThemeColors` with id `statusBarItem.errorBackground`. Other `ThemeColors`
-		 * will be ignored.
+		 * Note: only `new ThemeColor('statusBarItem.errorBackground')` is
+		 * supported for now. More background colors may be supported in the
+		 * future.
 		 *
-		 * When setting the background color to `statusBarItem.errorBackground`, the
-		 * `color` property will automatically be set to `statusBarItem.errorForeground`.
+		 * Note: when a background color is set, the statusbar may override
+		 * the `color` choice to ensure the entry is readable in all themes.
 		 */
 		backgroundColor: ThemeColor | undefined;
 	}