diff --git a/docs/guides/concepts.md b/docs/guides/concepts.md index ce8a160f..8bee97e9 100644 --- a/docs/guides/concepts.md +++ b/docs/guides/concepts.md @@ -173,18 +173,17 @@ request based on the response, and so on. -### Deadlines +### Deadlines/Timeouts -gRPC allows clients to specify a deadline value when calling a remote method. -This specifies how long the client wants to wait for a response from the server -before the RPC finishes with the error `DEADLINE_EXCEEDED`. On the server side, -the server can query the deadline to see if a particular method has timed out, -or how much time is left to complete the method. - -How the deadline is specified varies from language to language - for example, a -deadline value is always required in Python, and not all languages have a -default deadline. +gRPC allows clients to specify how long they are willing to wait for an RPC to +complete before the RPC is terminated with the error `DEADLINE_EXCEEDED`. On +the server side, the server can query to see if a particular RPC has timed out, +or how much time is left to complete the RPC. +How the deadline or timeout is specified varies from language to language - for +example, not all languages have a default deadline, some language APIs work in +terms of a deadline (a fixed point in time), and some language APIs work in +terms of timeouts (durations of time). ### RPC termination