net: document the meaning of "Temporary" and "Timeout" #48268
Labels
Documentation
Issues describing a change to documentation.
NeedsInvestigation
Someone must examine and confirm this is a valid issue and not a duplicate of an existing one.
Milestone
The docs for
net
have a lot ofTemporary
andTimeout
error methods in them, but the package level docs don't contain a discussion of what those errors mean. TheTemporary
methods are mentioned in blog post about error handling but don't actually describe their meaning in detail.And then for the errors types specifically, if an error type have both
Temporary
andTimeout
, it'd be nice to document if both can be true at once and what that means semantically. (This originally cropped up when trying to explain if and when an error in a lower-level network protocol would or would not be counted against a rate limit in a higher-level one.)The text was updated successfully, but these errors were encountered: