db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From David Van Couvering <David.Vancouver...@Sun.COM>
Subject Re: [jira] Commented: (DERBY-1376) File java/engine/org/apache/derby/loc/messages_en.properties - Message XSLAT.D
Date Wed, 07 Jun 2006 17:43:55 GMT

Laura Stewart wrote:
> *** (LS) Please see my comments below.
> *** (LS) What is the limitation for messages in Derby?

I don't know if it's possible to have messages with multiple lines.  In 
general it's been our approach to have single-line messages.  If we want 
to change that, we should investigate to see if it's possible and 
discuss if that's what we want to start moving towards.  I'm not so sure...

>      > (I do like to say "please", it doesn't hurt to be polite to our
>     users).
>      >
>      > Also, it would be helpful to say *where* you specify logDevice (
>     e.g. "please make sure the derby.foo.logDevice property is set to
>     the correct location.")
> *** (LS) While I like to be polite too, we are not sitting down to tea 
> with the users :-) It is more professional in technical documentation to 
> leave the "Please" out. Besides, the key is not to be polite, but to 
> provide the information that users need to resolve the problem.

Ah, I beg to differ.  I think that users too often are treated too 
brusquely in the way a system communicates with them.  I like the 
metaphor that a system should act as a butler, ready to serve and always 
polite.  I don't see anything wrong with "please" and using full 
sentences -- "The directory {0} is not empty" instead of "Directory {0} 
not empty".  That's how robots in 1960s science fiction shows talk, not 
people.  I think culturally we have been taught that software systems 
should sound like robots and be very formal, but I don't think it's 
necessary or even what customers want.

Thanks (he says politely),


>     I think additional explanation is not  really required. User will see
>     this error only when the s/he uses the logDevice attribute on the URL.
>     Thanks
>     -suresh
> -- 
> Laura Stewart

View raw message