diff --git a/docs/.nojekyll b/docs/.nojekyll
new file mode 100644
index 0000000..e69de29
diff --git a/docs/vendor/README.md b/docs/vendor/README.md
index 4a8d682..f5e9e67 100644
--- a/docs/vendor/README.md
+++ b/docs/vendor/README.md
@@ -3,3 +3,8 @@
 Generated by `npm run build:docs`. Do not edit by hand.
 
 - `babel.min.js` — @babel/standalone 8.0.4, used by the playground to compile TypeScript with standard decorators in the browser. Vendored rather than loaded from a CDN: the previous page referenced an unpinned unpkg URL, which silently began serving Babel 8 and broke the playground.
+
+`../.nojekyll` sits alongside these files so GitHub Pages serves the directory verbatim
+instead of running it through Jekyll. Jekyll's conventions — ignoring paths that begin with
+an underscore, and its default `vendor/` exclusions — are a poor fit for a hand-built page
+whose playground 404s the moment one asset silently fails to publish.