[ 
https://issues.apache.org/jira/browse/MATH-361?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12882301#action_12882301
 ] 

Luc Maisonobe commented on MATH-361:
------------------------------------

We all agree we need to reduce the number of enums.
What I don't agree with is the fact error messages are for the set of users 
that must read the javadoc. Error messages are for end users, some of them not 
even knowing commons-math is used in an application they use. They don't read 
the javadoc, they don't develop the application.
But when a statistician tries to set up a gamma distribution and get a message 
about alpha being negative, he will better understand what his input error was 
than if a generic "negative parameter" message was displayed.

Perhaps this example about alpha is a little extreme, and I won't argue long 
for this specific exception if you insist on it being replaced by a more 
general one. But don't be too drastic in the reduction of the number of 
messages and more importantly don't consider messages are for developers using 
directly commons math. There will be lot of layers between our very low level 
component and a complete end user application, but some messages will go 
through all these layers and be finally displayed to users. These messages 
should provide as much information to them as we can provide.

Users are the most important part of a system.

> Localization and Error Handling
> -------------------------------
>
>                 Key: MATH-361
>                 URL: https://issues.apache.org/jira/browse/MATH-361
>             Project: Commons Math
>          Issue Type: Improvement
>    Affects Versions: 2.1
>            Reporter: Gilles
>            Priority: Minor
>         Attachments: l10n.tar.gz, res.tar.gz
>
>
> This proposal aims at easing the handling of error during algorithms 
> development, and also enhancing the flexibility of the error reporting 
> (provide meaningful exception classes and run-time selection of the 
> localization formatting).
> More details at 
> [http://www.mail-archive.com/[email protected]/msg14570.html]

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.

Reply via email to