[Python-Dev] Using logging in the stdlib and its unit tests

[Oleg Broytman]

On Fri, Dec 10, 2010 at 06:47:50PM +0900, Stephen J. Turnbull wrote:
> Vinay Sajip writes:
>  > Indeed, and the very first code sample in the logging documentation
>  > shows exactly the simplistic easy usage you're talking about. I
>  > can't see why anyone would be scared off by that example.
> 
> They're not scared by that example.  What you need is a paragraph
> below it that says
> 
>     """
>     Do you think the above is all you should need?  If so, you're
>     right.  You can stop reading now.  If you think you need more,
>     we've got that, too.  Read on (you may need more coffee).
>     """ 

   Better yet (IMHO) would be to split the huge page into "Logging: Simple
start" and "Logging: Advanced usage (for the brave of of heart)".

Oleg.
-- 
     Oleg Broytman            http://phd.pp.ru/            phd at phd.pp.ru
           Programmers don't die, they just GOSUB without RETURN.