[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-03-31 UTC."],[[["\u003cp\u003eError messages should clearly state the problem, including specific details like sizes, limits, or timeouts, instead of generic phrases.\u003c/p\u003e\n"],["\u003cp\u003eInclude information about why the error occurred, such as user permissions or system constraints, to aid user understanding.\u003c/p\u003e\n"],["\u003cp\u003eOffer solutions or further guidance by linking to relevant resources or explaining how to resolve the issue, enhancing the user experience.\u003c/p\u003e\n"]]],["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"],null,["\u003cbr /\u003e\n\nHelp users understand requirements and constraints. Be specific.\nDon't assume that users know the limitations of your system.\n\nNot recommended\n\u003e The combined size of the attachments is too big.\n\nRecommended\n\u003e The combined size of the attachments (14MB) exceeds the allowed limit (10MB). *\\[Details about possible solution.\\]*\n\n*** ** * ** ***\n\nNot recommended\n\u003e Permission denied.\n\nRecommended\n\u003e Permission denied. Only users in \\\u003cgroup name\\\u003e have access. *\\[Details about adding users to the group.\\]*\n\n*** ** * ** ***\n\nNot recommended\n\u003e Time-out period exceeded.\n\nRecommended\n\u003e Time-out period (30s) exceeded. *\\[Details about possible solution.\\]*\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n**Next unit:** [Explain how to fix the problem](/tech-writing/error-messages/show-fix)"]]
