diff --git a/serverless/workers/github-integration.mdx b/serverless/workers/github-integration.mdx
index 10f013b7..d6024732 100644
--- a/serverless/workers/github-integration.mdx
+++ b/serverless/workers/github-integration.mdx
@@ -247,7 +247,11 @@ To disconnect your GitHub account from Runpod:
 
 Runpod has the following limitations when using the GitHub integration to deploy your worker:
 
-* **Build time limit**: Builds must complete within 160 minutes (2.5 hours). Optimize your Dockerfile for efficiency with large images to avoid timeouts.
+* **Build time limit**: The GitHub integration has two separate time limits:
+  * **Total build window**: The entire build process (cloning, building, uploading, and testing) must complete within 160 minutes (2.5 hours).
+  * **Docker build timeout**: The `docker build` step must complete within 30 minutes. If your dependencies or model weights take longer to download and install, pre-build your image locally and push to a container registry instead.
+  
+  If you see an error like "Build exceeded maximum time limit of 1800 seconds (30.0 minutes)", this refers to the Docker build timeout, not the overall 160-minute limit.
 * **Image size restriction**: Docker images cannot exceed 80 GB. Plan your image requirements accordingly, particularly when including large model weights or dependencies.
 * **Base image limitations**: The integration doesn't support privately hosted images as base images. Consider incorporating essential components directly into your Dockerfile instead.
 * **Hardware-specific builds**: Builds requiring GPU access during construction (such as those using GPU-compiled versions of libraries like `bitsandbytes`) are not supported.