diff --git a/README.md b/README.md
index 3adbc0b2..69e39c73 100644
--- a/README.md
+++ b/README.md
@@ -480,6 +480,7 @@ axios
     params: {
       ID: 12345,
     },
+    timeout: 5000, // 5 seconds — see "Handling Timeouts" below for matching error handling
   })
   .then(function (response) {
     console.log(response);
@@ -502,6 +503,9 @@ async function getUser() {
 }
 ```
 
+> **Note**: Set a `timeout` in production — without one, a stalled request can hang
+> indefinitely. See [Handling Timeouts](#handling-timeouts) for the matching error handling.
+
 > **Note**: `async/await` is part of ECMAScript 2017 and is not supported in Internet
 > Explorer and older browsers, so use with caution.
 
diff --git a/docs/pages/getting-started/first-steps.md b/docs/pages/getting-started/first-steps.md
index 16021c91..91e6d3bc 100644
--- a/docs/pages/getting-started/first-steps.md
+++ b/docs/pages/getting-started/first-steps.md
@@ -68,6 +68,18 @@ console.log(response.data);
 
 axios provides a simple API for making requests. You can use the `axios.get` method to make a GET request, the `axios.post` method to make a POST request, and so on. You can also use the `axios.request` method to make a request with any method.
 
+::: tip Set a timeout in production
+Without a `timeout`, a stalled request can hang indefinitely. Pass one via the request config:
+
+```js
+const response = await axios.get("https://example.com/data", {
+  timeout: 5000, // 5 seconds
+});
+```
+
+See [`timeout` in the request config](/pages/advanced/request-config#timeout) and [Error handling](/pages/advanced/error-handling) for the matching `ECONNABORTED` / `ETIMEDOUT` codes.
+:::
+
 ## Next steps
 
 Now that you've made your first request with axios, you're ready to start exploring the rest of the axios documentation. You can learn more about making requests, handling responses, and using axios in your projects. Check out the rest of the documentation to learn more.