In my experience, basic rules for error messages and examples are often ignored, which leads to serious or critical usability problems.
I offer the following advice:
- Error messages
Great error messages are constructive, comprehensible, precise, visible, and polite;
Writing usable error messages;
- Writing great examples
Contrast between examples;
Explanations in examples;
Non-optimal examples; and more.