Description

The logging documentation [1] is incomplete and confusing to users unfamiliar with the logging module's dictionary configs, and Python's own docs are pretty poor on this so they don't take up the slack.

Specifically, I think our docs should explain how to specify the filename used by a handler that writes to a file, by adding the 'filename' key to the dictionary, and elaborate by saying that any kwarg accepted by any handler type's init may be used here.

This tripped me up, and I just saw the same question asked on django-users by someone trying to figure out how to configure a SysLogHandler.

All other keys are passed through as keyword arguments to the handler’s constructor.

That sounds clear and straightforward There's even an example with a 'filename' just below. So I don't really understand why you find that the docs are poor or that this information is difficult to find.

The logging documentation may be intimidating, but:

I really believe that this information belongs to Python's docs, and that it's not a good idea to start duplicating information in Django's docs,

There are already exactly the proper link in Django's docs.

Django developers are expected to be able to read 10 lines from the Python docs.