The table on logging debug levels is unclear

[far-authentise]

Existing Table

Many readers need a quick discussion to interpert the current table:

Level	Numeric value
logging.CRITICAL	50
logging.ERROR	40
logging.WARNING	30
logging.INFO	20
logging.DEBUG	10
logging.NOTSET	0

Suggested Table

Level	Numeric value	Info
logging.CRITICAL	50	Only crashing bugs
logging.ERROR	40	The above, & major errors
logging.WARNING	30	The above, & minor errors
logging.INFO	20	The above, & detailed info
logging.DEBUG	10	The above, & 'helpful' messages
logging.NOTSET	0	No error logging

The number of times I've had a bug in code due to the misunderstanding, or the number of times I've needed a whiteboard and 5 minutes to explain this concept is astounding. For some reason, it's just not intuitive for like 1/3 of people I have trained or worked with.

Linked PRs

• gh-107877: Update logging levels reference table with usage criteria. #107894
• [3.11] gh-107877: Update logging levels reference table with usage criteria. (GH-107894) #107921
• [3.12] gh-107877: Update logging levels reference table with usage criteria. (GH-107894) #107922

[tyler-authentise]

As an unbiased user I also think this is a great Idea 👍

[AA-Turner]

cc: @vsajip

[AA-Turner]

Perhaps this table should link to the table in the HOWTO, which does give descriptive overviews? It may be that those descriptions aren't discoverable enough.

That table might also include information on NOTSET, as it does not mean "No error logging", but rather one of two things dependent on status as the root logger.

A