UX / Общее UX+Usability / API
Недавно прочитал замечательную статью User experience design for APIs. Крайне рекомендую прочитать. И не смотрите, что это блог Keras — советы применимы к любому коду.
Мои рассуждения на эту тему:
Можно рассматривать подобные проблемы точно так же как “code smells” и постепенно рефакторить. Я в своём коде уже поправил несколько невнятных сообщений об ошибках, которые теперь делятся своими предположениями о причинах и предлагают способы решения.
UX / Общее UX+Usability / API