From Fedora Project Wiki
(Created page with '=== Anaconda Messagification -- Suggestions on Readability and Style') |
No edit summary |
||
Line 1: | Line 1: | ||
== Anaconda Messagification -- Suggestions on Readability and Style == | |||
* Never use elipses. There's really just no place for dramatic pause in what we're presenting. | |||
* Exclaimation points should be avoided. The fact that we're starting text mode is not exciting, it's somber and depressing. | |||
* Avoid statements of ownership. Custom partitioning is not "specifying your own partitioning", it's just specifying partitioning. | |||
* Dialog titles should specify a category, not the verb which is being done within that category. "Running" does not tell a user to what the dialog refers. | |||
* Avoid jargon and abreviations that aren't in common usage outside of Anaconda. We do not run scripts "post-install", we run "post-installation scripts". |
Revision as of 15:58, 10 July 2009
Anaconda Messagification -- Suggestions on Readability and Style
- Never use elipses. There's really just no place for dramatic pause in what we're presenting.
- Exclaimation points should be avoided. The fact that we're starting text mode is not exciting, it's somber and depressing.
- Avoid statements of ownership. Custom partitioning is not "specifying your own partitioning", it's just specifying partitioning.
- Dialog titles should specify a category, not the verb which is being done within that category. "Running" does not tell a user to what the dialog refers.
- Avoid jargon and abreviations that aren't in common usage outside of Anaconda. We do not run scripts "post-install", we run "post-installation scripts".