Should easy to understand error messages be displayed?

by 0x1b35f4d22b2c8bc706bcfcc383a1ca77fb4fc600 (punkpink)

Linked Draft Proposal

Should easy to understand error messages be displayed?

Summary

A proposal to replace technical error messages with user-friendly alternatives and practical troubleshooting guidance.

Abstract

This proposal advocates replacing technical error messages within Decentraland with more accessible descriptions and a list of possible solutions to allow users to resolve problems independently.

Motivation

Error messages with technical language (especially when entering the world) can be frustrating for visitors and may discourage them from returning again. Providing simple, non-technical error explanations and possible troubleshooting steps can improve user satisfaction and retention.

Specification

Potential error messages will be rewritten in everyday language and each message will be accompanied by a set of recommended actions that users can take to resolve the problem. In the event that, due to complexity, it is not feasible to assign a precise description to each error message, a generic reason will be shown. This message should also appear alongside tips for possible solutions, such as checking your computer's time synchronization, ensuring VPNs are not in use, and other relevant steps.

Impacts

Anticipated impacts include reduced frustration among users when these incidents occur and possible resolution of the problem by the user.

Implementation Pathways

Implementation will involve the development team rewriting error messages and creating a list of tips or comprehensive troubleshooting guide that will be included in the same place where the error appears or alternatively in the Decentraland documentation.

Conclusion

By implementing user-friendly error messages, we can reduce user frustration and discontent, improve the overall experience, and potentially decrease the volume of support requests on the Discord server.

This proposal is summarized due to technical limitations. To view it complete and vote on it, visit the DCL DAO Governance dApp