> Do we need to clarify the Cookbook section 5.16.1 on what to log and on what
> level?

Here's a link some others don't have to look it up
http://argouml-stats.tigris.org/documentation/defaulthtml/cookbook/ch05s16.html

That section could certainly be improved ("warning - this describes an
imaginary subsystem"??), but the levels should be pretty self
explanatory.   I doubt anyone is actually confused about the different
between a user warning and a developer debug message if they stop to
think about it.  It's more likely that they found the debug level too
noisy and picked warning to separate from the noise.  Providing some
templates for more fine-grained control of DEBUG messages (by package)
might help with this issue.

If someone's going to work on this page, here are some things that
could be cleaned up:

- Make it more concise so the important ArgoUML-unique information
stands out.  Remove explanatory material.  Provide pointers to
tutorials for things like isDebugEnabled() and how to configure
logging.  A good goal would be 25% of its current size (remove 75% of
the text).

- Copy edit.  Things like "The WARN level designates potentially
harmful situations. This is if CG can't find all the information
required and has to make something up," make no sense.  Perhaps this
was copied from a different context where it did make sense, but it
doesn't now.

- Remove dead links

Tom

---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to