Canceled-context documentation is currently strewn about in individual function documentation, though it's a fairly important concept that needs to be understood.
In particular, users sometimes are under the impression that "all things which accept a context will error", which can lead to nasty surprises like selector.Select(ctx)'s blocking behavior (causing a deadlocked workflow). Selector's docs have been improved in #1131, and this will hopefully make its behavior easier to learn before it is needed.
And, since I noticed some small other things while writing this chunk of docs, I've rolled those changes into here as well.
Canceled-context documentation is currently strewn about in individual function documentation, though it's a fairly important concept that needs to be understood.
In particular, users sometimes are under the impression that "all things which accept a context will error", which can lead to nasty surprises like
selector.Select(ctx)
's blocking behavior (causing a deadlocked workflow). Selector's docs have been improved in #1131, and this will hopefully make its behavior easier to learn before it is needed.And, since I noticed some small other things while writing this chunk of docs, I've rolled those changes into here as well.