io::ErrorKind: Discuss matching

Closes rust-lang#89175

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>

Author: ijackson

library/std/src/io/error.rs

@@ -88,6 +88,15 @@ struct Custom {
 /// It is used with the [`io::Error`] type.
 ///
 /// [`io::Error`]: Error
+///
+/// # Handling errors and matching on `ErrorKind`
+///
+/// In application code, use `match` for the `ErrorKind` values you are expecting; use `_` to match
+/// "all other errors".
+///
+/// In comprehensive and thorough tests, you may need to cut-and-paste the current list of
+/// errors from here into your test code.  This seems counterintuitive, but is correct,
+/// as set out in [this blog post](https://diziet.dreamwidth.org/9894.html#diziet-what-to-do).
 #[derive(Clone, Copy, Debug, Eq, Hash, Ord, PartialEq, PartialOrd)]
 #[stable(feature = "rust1", since = "1.0.0")]
 #[allow(deprecated)]