diff --git a/usersguide.html b/usersguide.html index a8f9969..96b3205 100644 --- a/usersguide.html +++ b/usersguide.html @@ -153,7 +153,7 @@ that logging should be performed, before incurring the overhead of the logging m Yes, the logging methods will perform the same check, but only after resolving parameters.

-

General - Message Priorities

+

General - Message Priorities/Levels

It is important to ensure that log message are appropriate in content and severity. The following guidelines are strongly suggested: @@ -186,6 +186,12 @@ Expect these to be written to logs only. These NEED NOT be internationalized, but it never hurts... +

General - Default Message Priority/Level

+

+By default the message priority should be no lower than info. +That is, by default debug message should not be seen in the logs. +

+

Enterprise - Logging Exceptions

The general rule in dealing with exceptions is to assume that the user (developer using a tooling/middleware API) isn't going @@ -195,14 +201,21 @@ it's in your best interest to be prepared with the proactive tools necessary to demonstrate that your component works correctly, or at worst that the problem analyzed from your logs. For this discussion, we must make a distinction between different types of exceptions -based on what kind of boundries they cross: +based on what kind of boundaries they cross: