Nice writeup, indeed good for linking to.

Some minor nitpickings:

• I like to enclose both the file name and the error messages in quotes, to separate them clearly from your own message text. Especially error messages usually have several words, which sometimes makes parsing of the sentence difficult.
• I would also include the operation (read, write) which was desired.

By the way: autodie does all of that :)