18
you are viewing a single comment's thread
view the rest of the comments
view the rest of the comments
this post was submitted on 20 Mar 2026
18 points (100.0% liked)
Rust Programming
9243 readers
1 users here now
founded 7 years ago
MODERATORS
Since
contextis kind of on topic, what should one write there? Are there any principles for writing good context messages?Instead of "frobnicating" in this rough example, I could also write that we intend to "baz" afterwards or that we are "currently beebbooping" or "bar failed" or I could even mention "foo" or ...
From my (rather limited) experience, it seems most useful to describe what beebboop is about to do. Sometimes that is weird though, because then the context for foo, bar, and baz calls would be essentially the same.
I've kind of standardized on writing it as "Failed to bar when beebbooping, while fadoodling."
Maybe a more concrete example:
The while-part is optional, in case you've got a larger context.
Well, so is the rest of it, really. I may just write "Error when beebbooping", if I believe the error from
.bar()to describe itself rather well. Error handling is hard. 🫠But yeah, you kind of have to describe that an error occurred, rather than purely describing what you want to do, because
anyhowdoesn't prefix it or such.I just optimized the context messages and I'm now happy with:
The "0" context is especially important because it tells you which file is read-only. Here is the code for that:
I don't think something like "failed to clear dependencies using sqlite db '{}'" would be helpful. Something like "failed to" or "error when" does not really add any information. Just describe what is happening. Also, the "clear dependencies" would be redundant because that function can handle that part itself (see msg 1).