[documentation] [task] Drupal core installer messages
webchick
drupal-docs at drupal.org
Tue Feb 28 17:20:30 UTC 2006
Issue status update for
http://drupal.org/node/51772
Post a follow up:
http://drupal.org/project/comments/add/51772
Project: Documentation
Version: <none>
Component: Misc
Category: tasks
Priority: critical
Assigned to: Anonymous
Reported by: webchick
Updated by: webchick
Status: active
Attachment: http://drupal.org/files/issues/messages.txt (8.96 KB)
Attached is a list of error/status messages that the Drupal core
installer [1] generates. This list may be out of date by now; if so I
will post a follow-up that contains the new versions.
The idea is to make these error messages friendly and readable to
anyone who might be installing the software. The basic formula for good
error messages is:
1. What's the problem?
2. How do I fix the problem?
3. How do I avoid the problem in the future?
Here are some resources on writing good error messages I've come across
during my research:
* Error Message Guidelines [2]
* Error messages: More important to your website than you think [3]
* How to write Error Messages [4]
This is A LOT harder than it looks. :P But if you have experience
writing error messages, it would be awesome if you could lend a hand
here because we're pushing to get the installer finished ASAP. Remember
that this is the first impression people will have of Drupal, so we want
to make it as welcoming and friendly as possible.
Thank you very much.
[1] http://drupal.org/node/48732
[2] http://www.useit.com/alertbox/20010624.html
[3] http://www.marketingprofs.com/3/stoeckle1.asp
[4]
http://www.klariti.com/technical-writing/writing-error-messages.shtml
webchick
More information about the documentation
mailing list