Fix non-specific error message "Failed to apply commands"
In !55457 (merged), several of us discussed the Failed to apply commands alert that displays when a user attempts an invalid quick action in a comment. This issue is to track the work of creating a better error message, and implementing it.
An ideal error message would include both a helpful message, and a link to more information to help the user self-solve the problem. Some ideas for the helpful-message portion:
- Command not recognized. Review your command and try again.
- Unrecognized command. Edit your command and try again.
- Comment not saved. Fix your command and try again.
- Comment not saved due to an invalid command.
For the link to self-solve, consider something like
(What commands can I use?) that links to https://docs.gitlab.com/ee/user/project/quick_actions.html
Alternately, could we create a generic error message that wraps around the API response, like this?
- Comment not saved. Reason: [insert API result here]
In addition to clarity surrounding the text, help or sample text for details that require specific syntax. Users see the
> symbols in date-related help text and presume it's part of a formula that they need to include to write out the quick action. However, it causes an error that is a bit vague:
(Leaving assigned to myself for now, and adding %Next 1-3 releases as a provisional milestone as I think UI work is both important and not-time-consuming for me.)