diff --git a/extensions/ql-vscode/.storybook/preview.js b/extensions/ql-vscode/.storybook/preview.js
index fe7a78eab..409066d60 100644
--- a/extensions/ql-vscode/.storybook/preview.js
+++ b/extensions/ql-vscode/.storybook/preview.js
@@ -6,14 +6,18 @@ import '@vscode/codicons/dist/codicon.css';
 
 import '../src/stories/vscode-theme.css';
 
+// https://storybook.js.org/docs/react/configure/overview#configure-story-rendering
 export const parameters = {
+  // All props starting with `on` will automatically receive an action as a prop
   actions: { argTypesRegex: "^on[A-Z].*" },
+  // All props matching these names will automatically get the correct control
   controls: {
     matchers: {
       color: /(background|color)$/i,
       date: /Date$/,
     },
   },
+  // Use a dark theme to be aligned with VSCode
   docs: {
     theme: themes.dark,
   },