tools: add docs for prefer-util-format-errors rule

I had a little trouble understanding what the rule was trying to say, so am documenting what would pass/fail.

Checklist

• documentation is changed or added
• commit message follows commit guidelines

Affected core subsystem(s)

tools