commons-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Luc Maisonobe (JIRA)" <>
Subject [jira] Commented: (MATH-361) Localization and Error Handling
Date Thu, 24 Jun 2010 19:50:50 GMT


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:
>             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 []

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

View raw message