diff --git a/website/source/docs/providers/aws/r/api_gateway_deployment.html.markdown b/website/source/docs/providers/aws/r/api_gateway_deployment.html.markdown
index 2f95fecc1..4ad0a5950 100644
--- a/website/source/docs/providers/aws/r/api_gateway_deployment.html.markdown
+++ b/website/source/docs/providers/aws/r/api_gateway_deployment.html.markdown
@@ -10,8 +10,8 @@ description: |-
 
 Provides an API Gateway Deployment.
 
--> **Note:** Depends on having `aws_api_gateway_method` inside your rest api. To ensure this
-you might need to add an explicit `depends_on` for clean runs.
+-> **Note:** Depends on having `aws_api_gateway_integration` inside your rest api (which in turn depends on `aws_api_gateway_method`). To avoid race conditions
+you might need to add an explicit `depends_on = ["aws_api_gateway_integration.name"]`.
 
 ## Example Usage