From 4b1ba679f6d806e6f077b05846ff1e7bce76453f Mon Sep 17 00:00:00 2001 From: Lennart Poettering Date: Fri, 25 Jul 2008 16:06:36 +0200 Subject: document why dialog-error and not error-dialog --- spec/sound-naming-spec.xml | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/spec/sound-naming-spec.xml b/spec/sound-naming-spec.xml index 9d63860..f313c3b 100644 --- a/spec/sound-naming-spec.xml +++ b/spec/sound-naming-spec.xml @@ -158,7 +158,17 @@ usage. result. However, if the more specific item does not exist in the current theme, and does exist in a parent theme, the generic sound from the current theme is preferred, in - order to keep consistent style. + order to keep consistent style. From left to right the + words in a sound name become more specific. In some cases + what word in a name is more specific is + ambiguous. (i.e. "dialog-error" and "error-dialog" both + make sense, the former would ease defining the same sound + for all dialogs popping up, regardless of its context, the + latter would ease defining the same sound for all errors, + regardless of how it is presented to the user). In such + cases it is generally preferred to put the UI element noun + left -- if there is one --, however exceptions of this + rule are acceptable. -- cgit