adds explanation of timeout behavior when passing an array of a… (cyp…

…ress-io#2648)

source/api/commands/wait.md

@@ -136,6 +136,8 @@ cy.get('#book-results').should('have.length', 1)
 
 ### You can pass an array of aliases that will be waited on before resolving.
 
+When passing an array of aliases to `cy.wait()`, Cypress will wait for all requests to complete within the given `requestTimeout` and `responseTimeout`.
+
 ```javascript
 cy.server()
 cy.route('users/*').as('getUsers')
@@ -209,6 +211,10 @@ This means Cypress will now wait up to 20 seconds for the external server to res
 
 This gives you the best of both worlds - a fast error feedback loop when requests never go out and a much longer duration for the actual external response.
 
+### Using an Array of Aliases
+
+When passing an array of aliases to `cy.wait()`, Cypress will wait for all requests to complete within the given `requestTimeout` and `responseTimeout`.
+
 # Rules
 
 ## Requirements {% helper_icon requirements %}