diff --git a/.changeset/serious-fishes-lay.md b/.changeset/serious-fishes-lay.md
new file mode 100644
index 000000000..c619513dc
--- /dev/null
+++ b/.changeset/serious-fishes-lay.md
@@ -0,0 +1,5 @@
+---
+'docs': patch
+---
+
+Github pages disclaimer
diff --git a/docs/src/pages/guides/deploy.md b/docs/src/pages/guides/deploy.md
index e5e3db1c9..de98b9e3f 100644
--- a/docs/src/pages/guides/deploy.md
+++ b/docs/src/pages/guides/deploy.md
@@ -31,6 +31,8 @@ By default, the build output will be placed at `dist/`. You may deploy this `dis
 
 ## GitHub Pages
 
+> **Warning:** By default, Github Pages will break the `_astro/` directory of your deployed website. To disable this behavior and fix your this issue, make sure that you use the `deploy.sh` script below or manually add an empty `.nojekyll` file to your `public/` site directory.
+
 1. Set the correct `buildOptions.site` in `astro.config.mjs`.
 1. Inside your project, create `deploy.sh` with the following content (uncommenting the appropriate lines), and run it to deploy: