db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Laura Stewart" <scotsmat...@gmail.com>
Subject Re: [jira] Commented: (DERBY-1376) File java/engine/org/apache/derby/loc/messages_en.properties - Message XSLAT.D
Date Thu, 08 Jun 2006 00:59:08 GMT
*** (LS) Responses below

On 6/7/06, David Van Couvering <David.Vancouvering@sun.com> wrote:
> 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...

*** (LS) What is considered a line in Derby.. how many characters is the

> *** (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.

*** (LS) I agree that we need full and complete sentences. We definitely
want to avoid being cryptic or brusk.  Additionally, one thing that I think
we should avoid is any implication that the user has done something wrong,
to blame the user.  The "butler" would never say "It is your fault Sir."
The "please" issue is one that I think should go through the "guidelines"
review.  See what the community thinks.

Thanks (he says politely),

*** (LS) Por nada Senor (she says with grace).

> >
> >
> >     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

Laura Stewart

View raw message