Our recent discussions about supportability identified that improving the actionability of error messages (e.g. in logs and responses to clients) would help a significant proportion of users help themselves without needing to escalate questions to the support or development teams. For instance, this might include directly linking from the message to some relevant documentation. We did not go into much depth on what that might mean in practice, but I'm opening this issue to record the need for further discussions in this area. Feel free to take this issue forwards as you see fit, for instance by filling it out into a full meta-issue or by closing it in favour of some other more specific action items.

I'm labelling this for the attention of the core/infra team because I think there is scope for making this easier by adding features to our logging and exception-handling frameworks, noting of course that improvements to the error messages themselves would be owned by other teams.