diff --git a/tooling/lib/build.js b/tooling/lib/build.js
index <HASH>..<HASH> 100644
--- a/tooling/lib/build.js
+++ b/tooling/lib/build.js
@@ -44,6 +44,8 @@ exports.buildPackage = async function buildPackage(packageName) {
 
 exports.buildSamples = async function buildSamples() {
   await rimraf(`packages/node_modules/samples/bundle*`);
+  // reminder: samples:build calls this script, not webpack, hence we must call
+  // webpack here
   await exec(`webpack`);
   await rename(`bundle.js`, `packages/node_modules/samples/bundle.js`);
   await rename(`bundle.js.map`, `packages/node_modules/samples/bundle.js.map`);
style(tooling): add note for why we can't shell out to npm scripts