Specify requirements and constraints
Help users understand requirements and constraints. Be specific.
Don't assume that users know the limitations of your system.
Not recommended
The combined size of the attachments is too big.
Recommended
The combined size of the attachments (14MB) exceeds the allowed limit (10MB).
[Details about possible solution.]
Not recommended
Permission denied.
Recommended
Permission denied. Only users in <group name> have access.
[Details about adding users to the group.]
Not recommended
Time-out period exceeded.
Recommended
Time-out period (30s) exceeded. [Details about possible solution.]
Next unit: Explain how to fix the problem
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-08-06 UTC.
[null,null,["Last updated 2024-08-06 UTC."],[[["Error messages should clearly state the problem, including specific details like sizes, limits, or timeouts, instead of generic phrases."],["Include information about why the error occurred, such as user permissions or system constraints, to aid user understanding."],["Offer solutions or further guidance by linking to relevant resources or explaining how to resolve the issue, enhancing the user experience."]]],["Users need clear, specific details about system limitations. Instead of vague messages, provide concrete information, like the exact size of attachments exceeding the limit (e.g., \"14MB exceeds 10MB\") or the precise timeout period (e.g., \"30s\"). When indicating permissions issues, specify the group with access (e.g., \"\u003cgroup name\u003e\"). Provide context on what is exceeding the limitations, and then provide a way to solve the issues.\n"]]
