I have fixed some of this now.
/Linus
2008/9/4 Tom Morris <[EMAIL PROTECTED]>
> > 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]
>
>
