db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Jeff Levitt <de...@mylevita.com>
Subject Re: [jira] Commented: (DERBY-296) Document
Date Thu, 19 May 2005 18:08:50 GMT
Here's a text file that might help...it litst all the
messages with changes, and then the old and the new
version.

By the way, I am currently away on vacation, and my
access to email is limited.  Just wanted to explain
why you might not get responses from me on various
items of discussion from time to time.  I may not be
able to get to topics that people address to me until
I get back in a few weeks, but I will do my best.


--- David Van Couvering <david@vancouvering.com>
wrote:
> I could do this; every time I talk to customers they
> hammer into me that 
> clear and helpful error messages are key.
> 
> It would *really* help if I knew which message texts
> were modified in 
> the doc.  Is it limited to the Derby-specific
> messages with SQLStates 
> starting with "X"?
> 
> Would I submit this as an independent patch to the
> same JIRA item?  Note 
> also that I may find "bugs" in the messages that
> would require a redo of 
> the documentation...
> 
> David
> 
> Jean T. Anderson wrote:
> > David Van Couvering wrote:
> > 
> >> I would agree...  I think the right thing to do
> would be to fix the code.
> >>
> >> David
> > 
> > 
> > 
> > is that an offer?  :-)
> > 
> >  -jean
> > 
> > 
> >> Jean T. Anderson (JIRA) wrote:
> >>
> >>>      [ 
> >>>
>
http://issues.apache.org/jira/browse/DERBY-296?page=comments#action_65717
> 
> >>> ]
> >>>      Jean T. Anderson commented on DERBY-296:
> >>> ----------------------------------------
> >>>
> >>> Regarding this:
> >>>
> >>>
> >>>> During my work, I discovered that many of the
> messages could use 
> >>>> some spellchecking, grammar checking, etc.
> Rather than document them 
> >>>> this way, I corrected them. At some point a
> separate JIRA issue 
> >>>> should be made, and someone should undertake
> the task of fixing the 
> >>>> actual message strings to reflect the correct
> grammar, spelling, 
> >>>> punctuation, etc. used in this document.
> >>>
> >>>
> >>>
> >>>
> >>> I'm concerned users might be confused if the
> error message an 
> >>> application spits out does not exactly match the
> error message string 
> >>> documented in the Reference Manual.
> >>> I think this work shouldn't be committed until
> doc matches code 
> >>> (whether it involves changing the messages in
> this patch or modifying 
> >>> the code to match these).
> >>>
> >>>
> >>>
> >>>
> >>>
> >>>> Document
> >>>> --------
> >>>>
> >>>>         Key: DERBY-296
> >>>>         URL:
> http://issues.apache.org/jira/browse/DERBY-296
> >>>>     Project: Derby
> >>>>        Type: Task
> >>>>  Components: Documentation
> >>>> Environment: all
> >>>>    Reporter: Jeff Levitt
> >>>>    Assignee: Jeff Levitt
> >>>>    Priority: Minor
> >>>> Attachments: derby296.zip
> >>>>
> >>>> I've spent some time compiling a list of error
> messages for Derby, 
> >>>> to expand on the error messages section
> currently in the Reference 
> >>>> Manual.  I am about ready to submit a candidate
> patch, and I am 
> >>>> opening up a JIRA issue to contain it.
> >>>
> >>>
> >>>
> >>>
> > 
> 
Mime
View raw message