Update note about deps of APIGateway deployment (#12671)

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