#16140: Logging documentation should describe how to configure logging handlers.
-----------------------------------------+-------------------------------
Reporter: ShawnMilo | Owner: nobody
Type: Uncategorized | Status: new
Milestone: | Component: Documentation
Version: 1.3 | Severity: Normal
Resolution: | Keywords:
Triage Stage: Unreviewed | Has patch: 0
Needs documentation: 0 | Needs tests: 0
Patch needs improvement: 0 | Easy pickings: 1
-----------------------------------------+-------------------------------
Changes (by aaugustin):
* needs_better_patch: => 0
* needs_tests: => 0
* needs_docs: => 0
Comment:
Everything is described in [1] which is linked at the very beginning of
[2].
[1] http://docs.python.org/library/logging.config.html#configuration-
dictionary-schema
[2] https://docs.djangoproject.com/en/1.3/topics/logging/#configuring-
logging
Excerpt:
> 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.
So I'm rather strongly -1.
--
Ticket URL: <https://code.djangoproject.com/ticket/16140#comment:1>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.
--
You received this message because you are subscribed to the Google Groups
"Django updates" group.
To post to this group, send email to django-updates@googlegroups.com.
To unsubscribe from this group, send email to
django-updates+unsubscr...@googlegroups.com.
For more options, visit this group at
http://groups.google.com/group/django-updates?hl=en.
