diff --git a/website/docs/deployment.md b/website/docs/deployment.md
index b0433c02a6..9584f356be 100644
--- a/website/docs/deployment.md
+++ b/website/docs/deployment.md
@@ -67,6 +67,12 @@ module.exports = {
 }
 ```
 
+:::tip
+
+By default, GitHub Pages runs published files through [Jekyll](https://jekyllrb.com/). Since Jekyll will discard any files that begin with `_`, it is recommended that you disable Jekyll by adding an empty file named `.nojekyll` file to your `static` directory.
+
+:::
+
 ### Environment settings
 
 Specify the Git user as an environment variable.