diff --git a/README.md b/README.md
index 03e6c906..1f004fc9 100644
--- a/README.md
+++ b/README.md
@@ -53,6 +53,9 @@ All commands are run from the root of the project, from a terminal:
 | `npm run astro ...`       | Run CLI commands like `astro add`, `astro check` |
 | `npm run astro -- --help` | Get help using the Astro CLI                     |
 
+> [!NOTE]
+> To access error logs and help you proactively tackle docs build issues, simply run `npm run build` locally on your machine in your docs repo.
+
 ### 👀 Want to learn more?
 
 Check out [Starlight’s docs](https://starlight.astro.build/), read [the Astro documentation](https://docs.astro.build), or jump into the [Astro Discord server](https://astro.build/chat).